题干与适用场景
一个 Node.js 服务目前用 TypeScript 编译成 JavaScript，再由容器启动；团队希望直接执行 .ts 文件以缩短脚本和开发工具链。请说明内置 type stripping 的工作方式、支持边界、模块解析、配置限制、测试和生产发布策略。
面试官考察点
- 是否知道 Node.js 只移除类型标注，不做类型检查，也不生成运行时代码。
- 是否能识别枚举、带运行时代码的 namespace、参数属性、装饰器等不可擦除语法。
- 是否理解 Node.js 不读取
tsconfig.json，路径别名和目标转换不会自动生效。 - 是否能区分开发脚本、构建产物、依赖包和生产服务的风险边界。
回答前需要澄清的问题
- 目标是开发脚本、CLI、测试，还是长期运行的生产服务？
- 代码是否使用枚举、装饰器、参数属性、namespace 或路径别名？
- 当前模块模式、Node 版本、TypeScript 版本和发布镜像是否可统一？
- 团队是否需要完整类型检查、源码转换、source map 或旧 Node 版本支持？
30 秒回答框架
我会把内置能力定位为轻量执行器：它把可擦除的类型语法替换为空白，不检查类型，也不会为枚举或装饰器生成 JavaScript。先扫描代码并固定 Node 版本；使用 import type、显式扩展名和 module 规则，避免依赖 tsconfig 路径别名。需要完整 TypeScript 语义的服务继续使用编译器或 tsx，内置模式先用于脚本和小型工具。CI 同时运行类型检查、运行时测试和构建产物检查，再按故障率与启动时间决定范围。
分步骤深入解答
1. 解释类型擦除模型
Node.js 会把类型标注替换为空白，因此堆栈行号通常不需要 source map；它不会检查类型，也不转换需要生成 JavaScript 的语法。枚举、带运行时代码的 namespace、参数属性和装饰器会触发不支持错误。只有可擦除语法的文件才适合直接执行。
2. 固定模块和导入规则
Node.js 同时支持 CommonJS 与 ES module 的 TypeScript 文件，实际模式由包配置、扩展名和运行方式决定。类型导入必须使用 import type，否则擦除后仍会被当作值导入而在运行时失败。相对路径应写出可解析的扩展名，并通过 package.json 的 imports 等机制替代无法由 Node 转换的路径别名。
3. 处理 tsconfig 与依赖边界
内置执行器忽略 tsconfig.json，不会执行 target 降级、paths 映射或其他编译转换。Node.js 也拒绝处理 node_modules 目录下的 TypeScript 文件，以避免依赖包把源码执行当作发布契约。需要转换、装饰器或第三方 TypeScript 依赖时，继续使用完整编译器或运行时工具。
4. 设计迁移验证和回滚
先在 Node 版本矩阵中运行 lint、类型检查、单元测试、集成测试和启动探针，再比较编译模式与擦除模式的行为、启动时间和错误日志。锁定 Node 版本；v25.2 与 v24.12 起 type stripping 稳定，v26 移除实验性转换开关。生产失败时切回编译产物，而不是临时打开未支持语法转换。
高质量示范回答
我会把内置 type stripping 当作轻量的 TypeScript 执行路径，而非完整编译器。先盘点代码是否使用枚举、装饰器、参数属性、运行时 namespace、paths 别名或依赖包中的 TypeScript；这些能力需要转换或类型检查，继续保留编译器或 tsx。可迁移代码使用 import type、稳定的模块模式和可解析相对路径，类型检查仍由 tsc --noEmit 完成。Node.js 不读取 tsconfig，因此构建脚本要显式配置 package.json 和导入映射。先在开发脚本和 CLI 灰度，CI 比较启动探针、运行时错误、测试与镜像行为；v25.2/v24.12 起能力稳定、v26 移除实验转换开关。生产服务只有在矩阵验证通过后才切换，并保留编译产物回滚。
常见错误
- 把类型擦除当成类型检查或完整编译。
- 直接运行含枚举、装饰器、参数属性或运行时代码 namespace 的文件。
- 依赖
tsconfig的 paths、target 转换或 JSX 设置。 - 省略
import type，导致擦除后发生值导入错误。 - 让生产镜像执行
node_modules中未编译的 TypeScript。 - 只测启动速度，不运行类型检查、集成测试和旧版本矩阵。
追问及应对
为什么类型擦除通常不需要 source map？
实现通过替换为空白保留原始字符位置，运行时行号通常仍对应源文件。需要转换语法时仍应使用完整编译器和 source map。
什么时候必须保留 tsx 或编译器？
需要枚举、装饰器、参数属性、paths、target 转换、完整类型检查或处理 TypeScript 依赖包时，内置擦除无法满足契约，应保留工具链。
如何控制 Node 版本差异？
在镜像、CI 和本地工具中固定版本并做能力探测；把 type stripping 视为运行时前置条件，失败时执行已验证的 JavaScript 编译产物路径。