Node.js 原生支持 TypeScript 的演进之路

核心突破：

Node.js 22.6 首次引入实验性 TypeScript 支持，23.6 实现默认启用
采用创新的类型剥离（type stripping）技术，避免依赖 TS 配置
通过 SWC 编译器实现跨平台兼容，性能提升显著
TypeScript 使用率从 2016 年 34% 跃升至 2023 年 91%（State of JS 数据）

TypeScript 的生态统治力

2016 年 State of JS 调查显示，仅小部分开发者使用 TypeScript，34% 受访者表示不感兴趣。2023 年数据发生逆转：91% 开发者使用 TypeScript，仅 9% 坚持纯 JavaScript。Stack Overflow 2023 调查更将 TypeScript 列为第五大流行语言，npm 日下载量达 1200 万次，生态地位已不可撼动。

十年未解的集成难题

Node.js 维护者长期面临 TypeScript 集成需求，但存在多重技术障碍：

稳定性冲突

TypeScript 每个 minor 版本都可能含破坏性变更，而 Node.js LTS 需提供三年稳定支持，版本锁定机制不可行。

配置体系冲突

Node.js 无配置文件设计原则与 TypeScript 强依赖 tsconfig.json 的矛盾难以调和。

工具链困境

TypeScript npm 包体积达 24MB，直接嵌入 Node.js 会引发依赖管理和尺寸问题。

模块系统遗留问题

CommonJS/ESM 互操作性未完善前，集成 TypeScript 将导致运行时不可预测行为。

类型剥离：突破性的技术方案

2023 年，Node.js TSC 成员 Matteo Collina 提出创新方案——类型剥离（Type Stripping）：

工作原理

仅移除类型注解（如 : string），保留原始代码结构
空白占位技术维持源码行号，无需 source map
编译输出为标准 JavaScript，直接由 V8 执行

架构优势

解耦类型检查：开发者仍通过 tsc 或 IDE 执行校验
避免配置依赖：不解析 tsconfig.json
版本兼容性强：语法转换层比类型系统更稳定

示例：const message: string = "Hello" → 剥离为 const message = "Hello"

SWC 与 Amaro：高性能实现

技术方案依赖两大核心组件：

SWC 编译器：

采用 WebAssembly 实现跨平台支持
编译速度比 Babel 快 20 倍
已被 Next.js、Deno 等主流工具链采用

Amaro 封装层：

解耦 SWC 与 Node.js 核心
允许独立更新编译器和 TypeScript 版本
支持通过 --loader=amaro 启用

能力边界与最佳实践

支持范围

基础类型注解（interface, type alias）
泛型与类型参数（需配合 import type 语法）
通过 --experimental-transform-types 支持枚举/命名空间

关键限制

限制项	解决方案
必须显式文件扩展名（.ts）	使用 TS 5.7+ 路径重写功能或 codemod 迁移工具
不支持 node_modules 内的 TS 文件	设计上避免破坏现有模块生态
不降级新语法（如装饰器）	依赖目标 Node.js 版本的 V8 支持