TypeScript 中的 skipLibCheck

说明 skipLibCheck 为什么能加快大型项目的类型检查，以及它会跳过哪些声明文件检查、又可能掩盖哪些依赖冲突。

#tech / dev #resource / typescript #type / concept #status / growing

[!info] related notes

所属 MOC: TypeScript MOC

配置入口: tsconfig 使用详解

并列概念: TypeScript 中的 types 编译选项, TypeScript 中的 declaration 与 declarationMap

一句话定义

skipLibCheck 表示 TypeScript 跳过对声明文件的完整类型检查。

当配置：

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

时，TypeScript 不再完整检查所有 .d.ts 文件之间是否自洽。

它最直接的价值是：

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

很多前端 app 或大型 monorepo 会这样配，以换取更快的类型检查速度。

TypeScript 仍然会使用这些声明文件来理解你的代码。

它跳过的是：

而不是完全假装这些类型不存在。

如果项目里同时出现多份互相不一致的声明文件，skipLibCheck 可能让错误暂时不暴露。

这就是为什么官方文档更倾向于：

而不是长期把问题压在 skipLibCheck 下面。

应用项目里，它常被当成性能换准确性的工程折中。

但如果你在维护底层库、公共类型包或要对外发布的基础设施，长期依赖它就更容易把类型债务往后推。