TypeScript：如何修复npm包嵌入式类型定义的缺失导出问题？

这种第三方npm包类型定义缺失的情况我经常碰到，给你几个实用的解决方案，按推荐程度排序：

方案一：扩展原模块的类型定义（推荐） #

这种方法不需要修改node_modules里的文件，也不会覆盖原包的其他类型，是最稳妥的方式：

• 在你的项目中新建一个类型声明文件，比如src/types/foo.d.ts（路径可以根据项目结构调整，只要TypeScript能扫描到）
• 在文件中写入以下代码，扩展foo模块的类型，补充缺失的Bar导出项：

declare module 'foo' {
  // 根据实际情况定义Bar的结构，如果是接口就用interface，类型别名用type，类或函数对应调整
  export interface Bar {
    id: number;
    name: string;
    // 这里添加Bar的其他属性或方法
  }

  // 如果Bar是类，就这么写：
  // export class Bar {
  //   constructor(arg: string);
  //   someMethod(): void;
  // }
}

• 确保TypeScript能识别到这个文件：检查tsconfig.json的include字段，把类型文件所在目录加进去，比如：

{
  "include": ["src/**/*", "src/types/**/*"]
}

方案二：完全替换原包的类型定义 #

如果原包的类型定义有多处问题，或者你需要大幅修改，可以直接替换整个类型文件：

• 在项目中创建一个完整的类型文件，比如src/types/foo/index.d.ts
• 把node_modules/foo/index.ts.d里的所有内容复制到这个文件中，然后添加缺失的Bar导出项
• 在tsconfig.json中配置paths，让TypeScript优先加载你自定义的类型文件：

{
  "compilerOptions": {
    "paths": {
      "foo": ["./src/types/foo/index.d.ts"]
    }
  }
}

方案三：临时修改node_modules中的文件（不推荐） #

如果只是临时测试可以用这种方法，但不要长期依赖，因为下次执行npm install或yarn install时，修改会被覆盖：

• 直接打开node_modules/foo/index.ts.d文件
• 在合适的位置添加缺失的Bar导出，比如：

export interface Bar {
  // 定义结构
}

• 保存后重新编译TypeScript即可解决报错

长期最优解：给原包提交PR #

如果foo是开源包，最好的方式是直接修改原仓库的类型定义文件，然后提交Pull Request。这样不仅能解决自己的问题，还能帮助其他遇到同样问题的开发者。

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