#TypeScript 工程化配置

#高频配置

• strict：开启严格类型检查，是项目质量基线。
• target：控制输出语法版本；它不等于类型检查目标。
• module / moduleResolution：决定模块输出和依赖解析策略。
• paths：只改变 TypeScript 的解析提示，构建工具也必须同步配置 alias。
• isolatedModules：要求每个文件可被独立转译，适合 Babel、esbuild、Vite。
• skipLibCheck：跳过第三方声明文件检查，可减少耗时，但不能替代修复业务类型错误。
• noEmit：交给 Babel/esbuild 转译时只做类型检查。
• declaration：发布 TypeScript 包时生成 .d.ts。

#常见方案

开发构建可以用 Babel/esbuild/ts-loader 负责转译，再用 tsc --noEmit 做类型检查。Babel 和 esbuild 不执行完整类型检查，也不会自动生成类型声明；库项目通常需要单独执行 tsc --emitDeclarationOnly。