一、前言 干了8年TypeScript项目，从最初改一行代码等编译半小时，到现在增量编译秒级响应，遇到太多因为tsconfig配置瞎写导致的龟速开发体验。编译慢、IDE卡、类型检查拖后腿，这些坑老子都踩过。这次把TypeScript性能优化聊透，从编译器配置到构建流程，手把手带你把编译时间从分钟级压缩到秒级。 二、操作步骤

步骤1：诊断当前编译性能瓶颈

先搞清楚慢在哪，别瞎优化。用TypeScript内置的性能分析工具： ```bash # 创建tsconfig.dev.json用于性能分析 cat > tsconfig.perf.json << 'EOF' { "extends": "./tsconfig.json", "compilerOptions": { "diagnostics": true, "extendedDiagnostics": true, "measureAccurracy": true, "traceResolution": false, "listEmittedFiles": true, "listFiles": true, "explainFiles": true } } EOF # 运行一次编译，观察输出 npx tsc -p tsconfig.perf.json ``` 预期输出示例： ``` Files: 1,847 Lines of library: 45,221 Lines of code: 12,847 Lines of type defs: 8,423 Lines of comment: 3,218 Lines of whitespace: 9,847 Lines per second: 1,234,567 Parse time: 0.45s Bind time: 0.12s Check time: 2.34s <-- 这里高说明类型检查慢 Emit time: 0.89s total time: 3.80s Symbols: 78,456 Types: 23,456 Instantiations: 4,567 <-- 这里高说明泛型实例化过度 Memory used: 345MB Allocations: 1,234,567 ``` 重点关注Check time和 Instantiations的值，识别真正的瓶颈。

步骤2：优化tsconfig.json基础配置

检查并优化TypeScript编译选项，针对性能做调整： ```bash # 检查当前tsconfig配置 cat tsconfig.json ``` 关键性能参数配置示例（根据项目类型选择）： ```json { "compilerOptions": { "target": "ES2020", "module": "ESNext", "moduleResolution": "bundler", "lib": ["ES2020"], "skipLibCheck": true, "noEmit": false, "sourceMap": false, "declaration": false, "composite": false, "incremental": true, "tsBuildInfoFile": ".tsbuildinfo", "isolatedModules": true, "allowSyntheticDefaultImports": true, "esModuleInterop": true, "strict": true, "strictNullChecks": true, "strictFunctionTypes": false, "noImplicitAny": false, "noUnusedLocals": false, "noUnusedParameters": false, "exactOptionalPropertyTypes": false, "useUnknownInCatchVariables": false, "assumeChangesOnlyAffectDirectDependencies": true }, "include": ["src/**/*"], "exclude": ["node_modules", "dist", "**/*.test.ts"] } ``` 关键参数说明： - `skipLibCheck`: 跳过node_modules类型检查，性能提升30%+ - `incremental`: 增量编译，必开 - `tsBuildInfoFile`: 指定增量缓存文件位置 - `noUnusedLocals/noUnusedParameters`: 开发阶段可关闭，减少检查开销 - `assumeChangesOnlyAffectDirectDependencies`: 激进优化，文件改了只重编译直接依赖 ```bash # 验证配置生效，重新编译测试 time npx tsc -p tsconfig.json --noEmit ``` 预期输出： ``` real 0m2.34s user 0m2.12s sys 0m0.22s ``` 对比之前的3.8秒应该有明显提升。

步骤3：启用增量编译与项目引用

对于大型项目，启用增量编译和项目引用是杀手锏： ```bash # 在项目根目录创建 tsconfig.bases.json cat > tsconfig.bases.json << 'EOF' { "compilerOptions": { "target": "ES2020", "module": "ESNext", "moduleResolution": "bundler", "strict": true, "declaration": true, "declarationMap": true, "sourceMap": true, "composite": true, "incremental": true, "tsBuildInfoFile": "node_modules/.cache/.tsbuildinfo" } } EOF # 创建packages目录结构 mkdir -p packages/shared packages/api packages/web # 为每个包配置继承基础配置 cat > packages/shared/tsconfig.json << 'EOF' { "extends": "../../tsconfig.bases.json", "compilerOptions": { "outDir": "./dist", "rootDir": "./src" }, "include": ["src/**/*"] } EOF ``` ```bash # 使用项目引用实现增量构建 cat > tsconfig.json << 'EOF' { "files": [], "references": [ { "path": "./packages/shared" }, { "path": "./packages/api" }, { "path": "./packages/web" } ] } EOF # 测试增量构建 npx tsc --build --verbose ``` 预期输出示例： ``` Build Mode: Incremental Info Files: packages/shared/node_modules/.cache/.tsbuildinfo (new) packages/api/node_modules/.cache/.tsbuildinfo (new) packages/web/node_modules/.cache/.tsbuildinfo (new) Projects: packages/shared -> packages/shared/dist/index.d.ts packages/api -> packages/api/dist/index.js packages/web -> packages/web/dist/index.js Done in 4.2s ``` 再改一个文件测试增量效果： ```bash # 只改一个文件 touch packages/shared/src/utils.ts # 再次构建 npx tsc --build --verbose ``` 预期输出： ``` Build Mode: Incremental Projects: packages/shared -> packages/shared/dist/index.d.ts (incremental) Done in 0.3s ``` 从4.2秒降到0.3秒，这才是增量编译的正确用法。

步骤4：使用fork-ts-checker-webpack-plugin优化类型检查

Webpack项目类型检查放主进程太慢，用插件并行检查： ```bash # 安装插件 npm install --save-dev fork-ts-checker-webpack-plugin @babel/typescript ``` webpack.config.js配置示例： ```javascript const ForkTsCheckerWebpackPlugin = require('fork-ts-checker-webpack-plugin'); module.exports = { plugins: [ new ForkTsCheckerWebpackPlugin({ typescript: { diagnosticOptions: { semantic: true, syntactic: true, }, mode: 'write-references', memoryLimit: 4096, }, logger: { infrastructure: 'console', issues: 'console', }, }), ], }; ``` ```bash # 构建测试，观察是否并行执行类型检查 npm run build 2>&1 | grep -E "(ForkTsChecker|Time:|compiled)" ``` 预期输出示例： ``` [ForkTsCheckerWebpackPlugin] Start type checking... [ForkTsCheckerWebpackPlugin] Complete type checking in 8.234s Time: 1234ms compiled successfully in 1.2s ``` 类型检查在后台8秒完成，主构建只要1.2秒，用户无感知。

步骤5：优化TypeScript Loader配置

ts-loader或esbuild-loader的性能配置： ```javascript // ts-loader配置 module.exports = { module: { rules: [ { test: /\.tsx?$/, use: [ { loader: 'ts-loader', options: { transpileOnly: true, // 跳过类型检查 happyPackMode: true, // 多线程编译 getCustomTransformers: () => ({ before: [], after: [] }), ignoreDiagnostics: [7006, 7013], // 忽略特定警告 } } ], exclude: /node_modules/ } ] } } ``` 或者使用更快的esbuild-loader： ```bash npm install --save-dev esbuild-loader esbuild ``` ```javascript // esbuild-loader配置（推荐，速度比ts-loader快10倍） module.exports = { module: { rules: [ { test: /\.tsx?$/, loader: 'esbuild-loader', options: { target: 'es2020', loader: 'tsx', } } ] }, resolve: { extensions: ['.tsx', '.ts', '.js'] } } ``` ```bash # 切换后测试编译速度 npm run build ``` 预期输出： ``` Time: 345ms <-- esbuild比ts-loader快很多 assets 5 completed in 0.345s ```

步骤6：IDE与EditorConfig优化

IDE卡顿往往是TypeScript Language Service的问题： VSCode配置（.vscode/settings.json）： ```json { "typescript.tsdk": "node_modules/typescript/lib", "typescript.preferences.autoImportFileNames": false, "typescript.suggest.autoImports": false, "typescript.inlayHints.functionLikeReturnTypes.enabled": false, "typescript.inlayHints.parameterNames.enabled": "none", "typescript.suggest.classMemberSuggestions.enabled": false, "typescript.updateImportsOnFileMove.enabled": "never", "typescript.preferences.includePackageJsonInImportPaths": false, "typescript.referencesCodeLens.enabled": false, "typescript.implementationsCodeLens.enabled": false, "editor.formatOnSave": false, "editor.quickSuggestions": false } ``` 禁用不必要的功能，减少Language Service负担。 ```bash # 检查是否有大型类型定义文件拖累性能 find . -name "*.d.ts" -size +5M -ls ``` 大型类型文件（如rxjs、material-ui等）可以配置跳过： tsconfig.json追加： ```json { "typeAcquisition": { "enable": true, "disallowLibraryUsage": true, "include": [], "exclude": ["lodash", "rxjs", "uuid"] } } ``` ```bash # 重启TypeScript Language Server测试 # Mac code --reload-extensions # Linux killall code && code # 检查Language Server日志 code --inspect-extensions 2>&1 | head -20 ``` 预期输出显示内存使用和响应时间改善。 三、常见问题FAQ Q1：tsc -w改个文件整个项目重编译，怎么回事？ 你那是watch模式没配置好。增量编译需要两步：先tsc --build生成.tsbuildinfo，再用tsc --build --watch。只用tsc -w会每次全量重编译。另一个坑是include范围太大，把node_modules或者build目录也扫进去了，文件一多每次扫描就慢。检查你的tsconfig.json的include和exclude配置，确认没有冗余目录。 Q2：skipLibCheck开了会不会有类型问题？ 放心，skipLibCheck只跳过node_modules/@types和你自己.d.ts文件的类型检查，你项目源码里的类型检查照常进行。这个选项能省30%以上的检查时间，大多数时候库的类型定义有小问题不影响你业务代码编译。如果你追求零警告零错误，那这个关掉，但别怪我提醒你：有些庞然大物库（比如material-ui）类型检查能跑好几分钟。 Q3：增量编译缓存什么时候失效？怎么手动清理？ .tsbuildinfo文件被删除、或者引用它的文件结构变了才会失效。常见失效场景：改了tsconfig.json的compilerOptions、删了.tsbuildinfo文件、或者换了node_modules版本。手动清理用tsc --build --clean，然后再tsc --build重建。自动化场景建议在package.json的preinstall钩子里检测.tsbuildinfo是否存在，不存在就清理并重建。 Q4：Vite项目还是慢，有什么特殊优化？ Vite用esbuild做预构建，但ts-loader/esbuild-loader的类型检查是独立的。方案一：装vite-plugin-checker，把类型检查放worker线程。方案二：直接关掉类型检查，依赖IDE的实时检查和CI环节的类型检查，dev-server只做transpile。方案三：升级到Vitest，它的类型检查在测试运行时顺便完成，不用单独跑tsc。 四、总结 TypeScript性能优化核心在三点：增量编译要正确配置（incremental+tsBuildInfoFile）、类型检查要异步并行（fork-ts-checker或transpileOnly）、IDE服务要减少不必要的诊断。编译时间从分钟级压到秒级不是玄学，是合理配置加正确工具链的事。大型项目建议上项目引用（project references），增量构建能把你从等编译的焦虑里彻底解放出来。延伸阅读：TypeScript官方性能指南、tsbuild模式最佳实践、esbuild-loader与vite集成方案。 记住，调试阶段追求速度，生产构建再考虑严格性和完整性，开发流程优化才是真正的效率提升。` content = content.indexOf('') > 0 ? content.replace('', viewstyle + '') : viewstyle + content const iframe = document.querySelector('#viewcontent') const viewdoc = iframe.contentDocument viewdoc.open() viewdoc.write(content) viewdoc.close() iframe.height = viewdoc.body.scrollHeight + 20 })