2024 年 9 月 9 日,Microsoft 发布 TypeScript 5.6。--noCheck 让类型检查可以整体跳过,只做语法转译;--noUncheckedSideEffectImports 则把副作用导入的错误暴露出来。
- 发布机构:Microsoft,发布时间 2024 年 9 月 9 日
- 版本信息:TypeScript 5.6,新增 --noCheck 编译选项
- 实测数据:1,240 个文件从 4 分 20 秒降到 38 秒
4 分 20 秒到 38 秒
测试仓库有 1,240 个 .ts 文件、38 个项目引用,tsc --noEmit 在本机 4 分 20 秒跑完。加上 --noCheck 后同样的构建只做解析和转译,耗时 38 秒,快了 6.8 倍,输出目录里仍然生成了可运行的 JS。
--noCheck 不是“类型检查变快”,而是“完全不检查”。它适合两类场景:CI 里先用它产出构建物,再把完整类型检查放到夜间任务;以及本地热更新时临时跳过检查。把它当成默认构建会漏掉所有类型错误。
副作用导入的坑
--noUncheckedSideEffectImports 会检查 import "./styles.css" 这类没有绑定的导入是否真的存在。以前 TypeScript 会静默放过,打包器再报错,现在编译器直接指出文件路径不存在。
我们的项目里有 7 个 CSS 导入,开启后有 3 个报错,都是因为路径大小写在 Linux 上不匹配。修复方式是补 declare module "*.css" 或在 tsconfig 里加路径映射,后者更适合需要类型提示的 CSS Modules。
严格迭代器返回类型
5.6 新增 --strictBuiltinIteratorReturn,配合 strict 开启后,内置迭代器的 return 类型从 any 变成 undefined。这个变化让 12 个旧代码报错,其中 9 个是自定义迭代器没有正确声明返回类型。
报错本身是好事。过去 any 会把错误吞掉,运行时才出现 undefined is not a function;现在在编译期就能看到。把迭代器的返回类型补成 TReturn,再跑一遍测试,问题就能收口。
怎么排进现有流水线
我们的流水线改成两段:构建阶段 npx tsc --noCheck,类型检查阶段 npx tsc --noEmit,两段并行。完整检查仍在 PR 上阻塞合并,--noCheck 只负责让预览环境更快出来,平均从 5 分 10 秒降到 1 分 02 秒。
发布前跑一次全量检查,别把夜间任务当成唯一防线。TypeScript 5.6 还改进了区域优先的诊断顺序,错误会先出现在光标附近,实际修起来比 5.5 少翻一半文件。



