跳到正文
每周二、五更新 · 排障记录与可运行代码邮件订阅:hi@xiaoming1.cn
编程心得标志,字母 A 与代码尖括号组合编程心得Awesome Dev

TypeScript 5.6 的 --noCheck:大仓库类型检查从 4 分 20 秒降到 38 秒

笔记本电脑屏幕上打开的代码编辑器与彩色语法高亮
笔记本电脑屏幕上打开的代码编辑器与彩色语法高亮。配图为免费图库实拍,与本文主题对应。

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 少翻一半文件。

文中提到的命令与数据来自公开版本说明和本站测试机。换环境后数值会变,先在小规模数据上复跑一遍,再动生产。

相关

读完可以接着看

两件与本文问题域直接相关的产品。

把下一次故障写成可复用的记录

每周二、五发一封邮件,只放当周的排障笔记、命令清单和一处容易踩错的细节。不发广告,随时可退。

hi@xiaoming1.cn

也可以直接打电话:0668-339 7712,工作日 09:30 至 18:00。