除skipLibCheck外，如何解决node_modules类型错误并检查自定义.d.ts？

当然有更灵活的替代方案！完全不用全局开启skipLibCheck，既能避开第三方库的类型错误，又能保住你手写.d.ts文件的严格检查——下面给你几个实用的思路：

1. 用 include/exclude 精准过滤问题库 #

不要一股脑排除整个node_modules，而是只排除那些确实有类型错误的第三方库目录：

{
  "compilerOptions": {
    // 保留你的原有编译配置
  },
  "exclude": [
    "node_modules/problematic-lib-1",
    "node_modules/problematic-lib-2" // 把有问题的库逐个列出来
  ],
  "include": [
    "src/**/*",
    "types/**/*.d.ts" // 明确指定你的手写类型文件目录，确保它们被检查
  ]
}

这样TS会正常检查大部分第三方库和你自己的.d.ts，只跳过那些有问题的库。

2. 用 typeRoots 优先加载你的手写类型 #

如果你的.d.ts是对某个第三方库的更严格版本，可以通过typeRoots让TypeScript优先加载你自己的类型，而不是@types里的默认类型：

{
  "compilerOptions": {
    "typeRoots": ["./types", "./node_modules/@types"]
  }
}

比如你在./types/react/index.d.ts里写了更严格的React类型，TS会先加载这个文件，完全替代官方的@types/react，完美满足你的严格检查需求。

3. 针对局部代码跳过类型检查 #

如果只是个别第三方库的调用有类型问题，没必要全局配置，直接在代码里精准忽略：

• 忽略整个导入的类型错误：

  // @ts-ignore
  import wonkyLib from 'wonky-lib';
  

• 只忽略某一行的特定错误（推荐，比@ts-ignore更精准）：

  // @ts-expect-error 已知该函数返回类型不匹配，手动指定正确类型
  const data = wonkyLib.fetchData() as MyExpectedType;
  

4. 给第三方库打类型补丁 #

如果第三方库的类型错误很小，你可以直接修改它的.d.ts文件，然后用patch-package把修改保存为补丁，团队成员安装依赖时会自动应用：

1. 找到node_modules/xxx/index.d.ts，修复里面的类型错误
2. 安装工具：npm install patch-package --save-dev
3. 生成补丁：npx patch-package xxx
4. 把生成的patches目录提交到Git，其他人npm install时就会自动应用你的修复

这些方法都能让你在保留自己手写.d.ts严格检查的同时，灵活处理第三方库的类型问题，比全局开skipLibCheck要靠谱得多。

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