TypeScript 项目 tsc 编译慢怎么优化？

Question

仓乃文 · Accepted Answer

TypeScript 项目随着代码量增长，tsc 编译越来越慢，大项目全量类型检查可能要 1-2 分钟。

核心优化方案：
```json
// 1. 开启增量编译（性价比最高）
{ "compilerOptions": { "incremental": true } }
// 生成 .tsbuildinfo 缓存，二次编译只检查变化的文件

// 2. 跳过库的类型检查
{ "compilerOptions": { "skipLibCheck": true } }
// 不检查 node_modules 的类型，编译速度提升 30-50%

// 3. 项目引用（大型项目）
{
  "references": [
    { "path": "./packages/shared" },
    { "path": "./packages/app" }
  ]
}
// 每个子项目独立编译

// 4. 排除不需要检查的目录
{ "exclude": ["node_modules", "dist", "**/*.spec.ts"] }
```

开发环境优化：
```json
// 开发时 Vite 用 esbuild 转译 TS（极快），tsc 只做类型检查
{
  "scripts": {
    "dev": "vite",
    "typecheck": "tsc --noEmit",
    "build": "vite build && tsc --noEmit"
  }
}
```

补充说明：
- 规则：开发用 Vite 转译（快），CI 用 tsc 类型检查（准）
- incremental 是性价比最高的优化，一行配置提速 50%+
- skipLibCheck 对大项目效果显著，且风险低
- 不要为了速度关闭 strict，类型安全比编译速度重要