无npm环境下如何合并@types/lodash v4的d.ts文件为单个文件？

好问题！我完全理解维护不使用npm的遗留项目时的这种困扰——Lodash 4.x把类型定义拆分成了多个模块文件，不像3.x有一个省心的统一index.d.ts。下面给你几个实用的解决办法：

方案1：用TypeScript编译器（tsc）手动合并 #

这是最原生的方法，不需要额外工具：

• 首先把Lodash 4.x的所有类型定义文件下载到本地的一个文件夹（比如./lodash-types），这些文件就是官方类型库中拆分的各个模块（array.d.ts、collection.d.ts、object.d.ts等）。
• 创建一个新的入口文件index.ts，在里面导入所有Lodash模块的导出内容：

  export * from './lodash-types/array';
  export * from './lodash-types/collection';
  export * from './lodash-types/date';
  export * from './lodash-types/function';
  export * from './lodash-types/lang';
  export * from './lodash-types/math';
  export * from './lodash-types/number';
  export * from './lodash-types/object';
  export * from './lodash-types/seq';
  export * from './lodash-types/string';
  export * from './lodash-types/util';
  

• 运行TypeScript编译命令，生成合并后的单个类型文件：

  tsc index.ts --declaration --emitDeclarationOnly --outFile lodash.d.ts
  

  参数说明：
  • --declaration：告诉编译器生成类型定义文件
  • --emitDeclarationOnly：只输出类型定义，不编译JS代码
  • --outFile：指定合并后的输出文件名

方案2：用dts-bundle-generator自动合并 #

如果手动写导入太麻烦，可以用专门的类型合并工具，步骤更简单：

• 临时使用npx运行工具（不需要全局安装，也不会影响你的遗留项目）：

  npx dts-bundle-generator ./lodash-types/index.d.ts -o lodash-merged.d.ts
  

  这个工具会自动分析所有依赖的类型模块，把它们合并成一个完整的lodash-merged.d.ts，还会处理重复类型和导出冲突。

方案3：按需手动合并（适合只用到部分Lodash功能的场景） #

如果你的项目只用到Lodash的一小部分方法，没必要合并所有类型：

• 找出项目中用到的Lodash模块对应的d.ts文件，比如用了_.debounce就找function.d.ts，用了_.cloneDeep就找object.d.ts
• 把这些文件中的类型定义和导出内容复制到一个新的index.d.ts里，注意用declare module 'lodash' { ... }包裹所有内容统一导出，并检查有没有重复的类型声明。

额外注意事项 #

• 升级Lodash到4.x时，除了类型定义，还要注意代码里的方法变更：比如_.extend变成了_.assignIn，_.contains变成了_.includes，这些API变动也要同步修改，避免运行时错误。
• 合并完成后，记得在项目中引用这个合并后的lodash.d.ts，确保TypeScript能正确识别Lodash的类型。

内容的提问来源于stack exchange，提问作者Marek