TypeScript 项目工程化实践：从 tsconfig 到 CI 的完整方案

一、tsconfig 的取舍

严格模式是 TypeScript 的灵魂。我的基线配置会开启 strict，但对部分历史项目采用渐进式：先开 noImplicitAny，再逐步收紧。

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "baseUrl": ".",
    "paths": { "@/*": ["src/*"] }
  }
}

二、路径别名与构建

• 用 paths 统一模块解析，配合打包工具别名保持运行时一致；
• 增量编译 incremental 显著缩短本地类型检查耗时；
• 类型产物与运行产物分离，避免把 .d.ts 打进 bundle。

三、CI 中的类型检查

在持续集成阶段单独跑 tsc --noEmit，把类型错误拦截在合并前，而不是依赖运行时报错。配合缓存可以将类型检查时间从分钟级降到秒级。

以上是一套可复制的工程化骨架，后续会再单独写 webpack / vite 的差异选择。