TypeScript 模块解析与声明文件合并难题
在使用 TypeScript 开发项目，特别是结合 pnpm 包管理工具时，模块解析和声明文件合并常常引发问题。例如，假设 math 包在 example 包中正常使用，TypeScript 类型解析无误。但当尝试扩展 math 包的 divide 函数声明时，问题出现。在 example 包中创建 math-extensions.d.ts 文件，试图通过 declare module 扩展 math 包的类型定义，却导致模块覆盖，VSCode 报错。
问题一：declare module 为什么没合并声明？VSCode 报错原因？
虽然 declare module 理应合并模块声明，但 VSCode 报错可能源于路径解析问题。假设 tsconfig.json 配置如下：
{
"compilerOptions": {
"outDir": "dist",
"baseUrl": ".",
"moduleResolution": "Node",
},
"include": [
"src/**/*"
]
}
TypeScript 使用 Node.js 模块解析策略 (moduleResolution: "Node")，按照 Node.js 规则查找模块。由于 math-extensions.d.ts 位于 example 包根目录，而非 src 文件夹内（include 选项仅包含 src/**/*），TypeScript 编译器可能无法正确解析该声明文件。VSCode 也可能使用不同的解析策略，导致无法正确识别和合并模块声明。 解决方法是确保声明文件在 tsconfig.json 的 include 路径内，或调整 include 选项包含这些声明文件。
问题二：非相对导入，为什么 math-extensions.d.ts 会生效？
使用非相对导入时，TypeScript 优先查找 node_modules 中的模块声明文件。但是，尤其在设置了 baseUrl 后，TypeScript 也会检查当前工作目录下的声明文件。
baseUrl 设置为 "."，TypeScript 从当前目录开始查找模块。因此，math-extensions.d.ts 生效，因为它位于当前目录且符合 baseUrl 设置。
为了避免模块覆盖，建议：
-
调整
include选项: 将math-extensions.d.ts包含在tsconfig.json的include路径中。 -
使用三斜线指令: 在
math-extensions.d.ts中使用三斜线指令///引用原始math包声明文件，确保声明合并正确性。 -
调整模块解析策略: 考虑调整
moduleResolution选项，或明确指定路径避免冲突。
通过以上方法，即可解决模块解析和声明文件合并问题，顺利扩展 math 包的类型声明。
