TypeScript：pnpm 项目中 math 包的模块解析与声明文件冲突
本文探讨在使用 pnpm 的 TypeScript 项目中，如何解决 math 包的模块解析和声明文件合并问题，特别是当扩展 math 包的类型声明时遇到的冲突。
问题场景
在一个使用 pnpm 创建的项目中，我们成功引入了 math 包并正常使用。然而，当我们尝试扩展 math 包的 divide 函数类型声明，并创建 math-extensions.d.ts 文件后，出现了模块覆盖问题，导致 VS Code 报错。
疑问解答
疑问一：declare module 不应该合并声明吗？为什么 VS Code 报错？
declare module 的确意图合并声明，但问题在于 TypeScript 编译器加载声明文件的顺序和优先级。如果 math-extensions.d.ts 的加载优先级高于 math 包自带的声明文件，就会发生覆盖，导致错误。
疑问二：使用非相对导入，为什么 math-extensions.d.ts 会生效？
虽然非相对导入优先查找 node_modules，但 TypeScript 编译器也会根据 tsconfig.json 中的 baseUrl 和 include 配置查找项目中的声明文件。如果 math-extensions.d.ts 位于 include 指定的目录下，且 baseUrl 为项目根目录，则会被加载。
解决方案
解决方法主要集中在避免声明文件冲突和控制加载顺序：
-
重命名或调整声明文件位置: 将
math-extensions.d.ts文件重命名，或移动到一个不会与math包声明文件冲突的目录，例如创建一个types目录专门存放自定义类型声明。 -
配置
tsconfig.json的paths: 通过paths配置，明确指定math模块的解析路径，优先加载node_modules中的声明文件。例如：{ "compilerOptions": { "outDir": "dist", "baseUrl": ".", "moduleResolution": "node", "paths": { "math": ["node_modules/math"] } }, "include": ["src/**/*"] }此配置确保 TypeScript 编译器在解析
math模块时，优先从node_modules目录加载其声明文件，避免被math-extensions.d.ts覆盖。
通过以上方法，可以有效解决 TypeScript 模块解析和声明文件合并问题，确保项目顺利编译运行。 记住，清晰的项目结构和合理的 tsconfig.json 配置是避免此类问题的关键。
