Node.js 22 和 23 版本 TypeScript 运行支持的变化

在最近的 Node.js 版本更新中,官方对 TypeScript(TS)文件的执行方式进行了重大调整,特别是 22 版本和 23 版本之间的差异较大。本文将详细解析这两个版本在 TypeScript 运行支持方面的变化。

一、Node.js 22 版本:实验性支持 TS 运行

Node.js 22 版本,默认情况下:

  • Node.js 无法直接运行 TypeScript 文件*.ts)。
  • 如果尝试 node myfile.ts,会报错,因为 Node.js 只能解析 JavaScript (*.js) 文件。
  • 但是,Node.js 22 引入了一个实验性特性 --experimental-transform-types,可以让 Node.js 直接运行 TypeScript 代码 ,但仅限于可擦除语法(erasable syntax)。

22 版本如何运行 TS 代码?

  1. 启用 TypeScript 运行支持:

    css 复制代码
    node --experimental-transform-types myfile.ts
    • 这个参数的作用是 允许 Node.js 直接运行 TypeScript 文件
    • 但它仅支持 可擦除语法,即 TypeScript 的类型信息会在运行前被移除,不影响 JavaScript 逻辑。
  2. 禁用 TypeScript 类型擦除:

    css 复制代码
    node --experimental-transform-types --no-experimental-strip-types myfile.ts
    • --no-experimental-strip-types 选项会 禁用自动去除 TypeScript 类型信息
    • 但这样做通常没有意义,因为原生 JavaScript 解析不了 TypeScript 类型,可能导致代码运行时报错。

总结 22 版本的关键点:

版本 默认支持 TS? --experimental-transform-types --no-experimental-strip-types
Node 22 ❌ 不支持 ✅ 需要手动开启 ❌ 仅决定是否移除 TS 类型,不影响是否能运行

二、Node.js 23.6.0 版本:默认支持 TypeScript

Node.js 23.6.0 版本之后,TypeScript 运行支持有了重要变化:

  1. 默认支持运行 *.ts 文件,不需要额外参数。
  2. --no-experimental-strip-types 被删除,因为 Node.js 现在默认会处理 TypeScript 的可擦除语法。
  3. 如果 TypeScript 代码包含不可擦除语法 (如 namespace),仍然需要 --experimental-transform-types 参数。

23 版本如何运行 TS 代码?

复制代码
node myfile.ts

直接运行 TypeScript 文件,无需额外参数!

但如果 TypeScript 代码包含不可擦除语法,则仍然需要 --experimental-transform-types

css 复制代码
node --experimental-transform-types myfile.ts

总结 23 版本的关键点:

版本 默认支持 TS? --experimental-transform-types --no-experimental-strip-types
Node 23.6.0 ✅ 默认支持 ✅ 仅在包含不可擦除语法时需要 🚫 被删除,不再需要

三、Node.js 22 vs 23 版本的 TypeScript 运行支持对比

特性 Node.js 22 Node.js 23.6.0
默认支持 TypeScript 运行 ❌ 需要 --experimental-transform-types ✅ 直接支持
可擦除语法 ✅ 需要 --experimental-transform-types ✅ 默认支持
不可擦除语法 ❌ 默认不支持 ❌ 仍需 --experimental-transform-types
--experimental-transform-types ✅ 允许 TS 运行(但需要手动开启) ✅ 仅在需要时使用
--no-experimental-strip-types ✅ 存在,可控制是否擦除类型 🚫 被删除,不再需要

四、结论

  • Node.js 22 版本 ,要运行 TypeScript 文件,必须手动添加 --experimental-transform-types
  • Node.js 23.6.0 版本之后 ,默认可以运行 TypeScript,但如果代码包含不可擦除语法,仍然需要 --experimental-transform-types
  • --no-experimental-strip-types 在 23.6.0 版本后被删除,因为 Node.js 现在默认会处理 TypeScript 的可擦除语法。

如果你在 Node.js 22 版本运行 TS 代码,需要手动启用 --experimental-transform-types,但在 23 版本之后,TypeScript 文件可以直接运行,体验更加流畅。

相关推荐
安生生申3 分钟前
uni-app 连接 JDY-31 蓝牙串口模块实践
c语言·前端·javascript·stm32·单片机·嵌入式硬件·uni-app
Restart-AHTCM7 分钟前
LangChain学习之模型 I/O 与输出解析器 (Output Parsers)(3/8)
前端·学习·langchain
lqj_本人8 分钟前
鸿蒙PC:electron-markdownify 从普通 Electron 迁移到 OpenHarmony Electron HAP 的完整实践
前端·javascript·electron
代码搬运媛8 小时前
Jest 测试框架详解与实现指南
前端
counterxing9 小时前
我把 Codex 里的 Skills 做成了一个 MCP,还支持分享
前端·agent·ai编程
wangqiaowq9 小时前
windows下nginx的安装
linux·服务器·前端
之歆10 小时前
DAY_12JavaScript DOM 完全指南(二):实战与性能篇
开发语言·前端·javascript·ecmascript
发现一只大呆瓜10 小时前
Vite凭什么这么快?3分钟带你彻底搞懂 Vite 热更新的幕后黑手
前端·面试·vite
Maimai1080810 小时前
React如何用 @microsoft/fetch-event-source 落地 SSE:比原生 EventSource 更灵活的实时推送方案
前端·javascript·react.js·microsoft·前端框架·reactjs·webassembly
kyriewen12 小时前
产品经理把PRD写成“天书”,我用AI半小时重写了一遍,他当场愣住
前端·ai编程·cursor