如何提升或调试TypeScript ts-node编译速度？编译耗时过长求助

首先直接给结论：10万行后端TS项目跑ESLint（依赖ts-node）耗时25秒，其中TS本身占20秒，这绝对是不正常的。后端项目通常不会有前端那样复杂的泛型嵌套或高频类型推导场景，正常情况下10万行代码的TS类型检查+ESLint应该能控制在5-10秒以内。

接下来分两步走：先定位耗时根源，再针对性优化：

一、排查耗时瓶颈 #

1. 用TypeScript官方工具追踪类型检查耗时 #

TS自带了性能追踪功能，能精准定位哪个文件/类型操作拖慢了速度：

tsc --generateTrace ./ts-trace

执行后会在ts-trace目录生成追踪文件，打开Chrome浏览器输入chrome://tracing，加载这个目录下的trace.json，就能看到完整的TS编译时间线——你能清晰看到哪个文件的类型检查耗时最长，或者是不是某个复杂类型（比如深层嵌套的泛型、交叉类型）在反复推导。

2. 用ESLint调试模式定位慢文件 #

开启ESLint的调试日志，看每个文件的处理耗时：

ESLINT_DEBUG=1 eslint --fix --cache

日志里会输出每个文件的处理时间，比如[ESLint] 123ms src/xxx.ts，很容易找出拖慢整体速度的“大文件”或者“问题文件”。

3. 检查tsconfig配置是否冗余 #

看看你的tsconfig.json是不是包含了不必要的文件：

• include是不是只包含了业务代码目录（比如src/**/*），而不是**/*（会把node_modules、测试文件甚至dist目录都加进来）
• exclude有没有正确排除node_modules、dist、temp这些不需要检查的目录
• 有没有开启一些非必要的严格模式选项？比如strictFunctionTypes、noImplicitReturns，如果项目不需要，可以暂时关闭试试，看耗时是否下降。

二、针对性优化方案 #

1. 拆分大文件 #

如果排查到某个超大文件（比如几千行的路由汇总、工具类），立刻拆分它。TS对小文件的类型推导效率远高于大文件，把单一文件拆成多个职责明确的小模块，能显著降低类型检查时间。

2. 优化TS增量编译 #

在tsconfig.json里开启增量编译：

{
  "compilerOptions": {
    "incremental": true,
    "tsBuildInfoFile": "./.tsbuildinfo"
  }
}

开启后TS会生成.tsbuildinfo文件，复用之前的编译结果，避免每次都全量检查，这能大幅降低重复运行时的耗时。

3. 优化ESLint缓存策略 #

默认的ESLint缓存是基于文件元数据（修改时间、大小）的，有时候元数据变化会导致缓存失效，试试改用内容哈希缓存：

eslint --fix --cache --cache-strategy content

同时确保.eslintcache文件没有被.gitignore（如果需要跨环境复用缓存的话），或者定期清理无效缓存。

4. 升级依赖到最新版本 #

TypeScript团队一直在优化类型检查速度，尤其是大项目的性能。确保你的typescript、@typescript-eslint/parser、@typescript-eslint/eslint-plugin都是最新稳定版，很多旧版本的性能问题在新版本里已经被修复。

5. 禁用非必要的ESLint规则 #

有些@typescript-eslint的规则非常耗时，比如@typescript-eslint/no-unused-vars（严格模式下会检查类型参数）、@typescript-eslint/explicit-function-return-type（需要推导返回类型）。如果这些规则不是项目必须的，可以暂时关闭，或者调整规则的配置（比如给no-unused-vars加上argsIgnorePattern: "^_"）。

6. 分离类型检查与ESLint #

如果实在难以优化，可以把流程拆成两步：

1. 先单独跑tsc --noEmit做类型检查（利用增量编译）
2. 再跑ESLint（此时可以用--no-ignore或者确保ESLint只检查已通过类型检查的文件）
   这样可以避免ts-node重复做类型检查，减少整体耗时。

内容的提问来源于stack exchange，提问作者user12341234