怎样为 TypeScript 项目建立可信的 Jest 测试链路，并避免测试通过但类型错误漏检

核心结论

一个可信的 TypeScript 测试链路必须区分“把测试代码转换成可执行的 JavaScript”“执行断言”“完成静态类型检查”三个职责。Jest 负责发现测试、隔离执行环境、提供匹配器与模拟能力，但它本身不等于完整的 TypeScript 类型检查器。若转换器只做快速转译，测试即使全部通过，也可能仍然存在类型错误。因此工程上应明确选择由 ts-jest、Babel、SWC 等工具承担转换，并单独运行 tsc --noEmit 或等价检查，不能把进程退出码为零直接理解成类型安全。

底层机制与决策依据

测试运行器拿到的源码通常要先经过转换，转换结果还要符合当前执行环境采用的模块格式。