Node.js 26 进入 Active LTS:升级前先核对的三件事
Node.js 26 进入 Active LTS:升级前先核对的三件事
2026 年 10 月 28 日,Node.js 26.13.0(代号 Lithium)正式成为 Active LTS,支持到 2029 年 4 月 30 日。同一时期,24 和 22 进入维护期,20 彻底结束生命周期。LTS 的意思不是"最新最好",而是"只修 bug 和安全问题,不引入破坏性变更"——生产环境选版本,拼的正是这条承诺。
但从旧版本升到 26 之前,有三件事值得先核对:支持周期、安全补丁、TypeScript 直跑的边界。每一件都有真实踩坑点,下面逐个讲。
第一件:先确认你现在在哪条线上
先跑一行命令,看清现状再谈升级:
node -v
# 我这台沙箱机器实测输出:v24.22.1
对照官方支持时间表:
Node.js 26:Active LTS(2026-10-28 起),维护到 2027-10-20,支持到 2029-04-30
Node.js 24:Maintenance LTS,支持到 2028-04-30
Node.js 22:Maintenance LTS,支持到 2027-04-30
Node.js 20:已结束生命周期,不再收到任何补丁
如果你还在 20 上,升级不是"要不要",而是"什么时候"——旧线收不到安全补丁,拖得越久风险越大。生产环境只用 Active LTS 或 Maintenance LTS,这是 Node.js 官方的原话。升级本身不难,难的是升级前不知道自己在用哪些已被移除的 API。
第二件:先打 10 月 21 日的安全补丁
2026 年 10 月 21 日,Node.js 为所有受支持的版本线发布了安全更新:26.12.1、24.22.1、22.23.4。其中最严重的是 CVE-2026-111497:Node.js 内置 Brotli 解码器(node:zlib)存在越界写,精心构造的压缩数据可能导致崩溃、内存泄露甚至远程代码执行。10 月 26 日已有安全厂商在监测网络上记录到针对 Node.js 24.22.0 的真实 exploit 尝试。
这意味着:即使你暂时不升 26,也必须先升到所在版本线的补丁版。检查方法很直接:
node -v
# v24.22.1 —— 已含 10 月 21 日补丁
# v24.22.0 —— 未打补丁,立即升级
# v22.23.4 / v26.12.1 —— 各线对应的已修复版本
升级命令按你的安装方式二选一:
nvm install 26.13.0 && nvm use 26.13.0
# 或直接装最新 LTS
nvm install --lts
我踩过的坑:只看大版本号就以为安全。24.22.0 和 24.22.1 只差一个补丁号,前面那个就是会被公开 exploit 打的版本。CI 里锁死小版本号,别只写 node: 24。
第三件:TypeScript 直跑的边界变了
Node.js 现在可以直接跑 .ts 文件:它只做类型剥离(type stripping),不做类型检查。这一点在 25.2.0 和 24.12.0 起已标记为稳定。但 Node.js 26 拿掉了一个关键开关:--experimental-transform-types 被移除了。
这个开关原来允许运行需要代码生成的 TypeScript 写法:enum、带运行时代码的 namespace、构造函数参数属性。26 以后规则变简单了:直接用 node 跑的代码,必须只用"可擦除语法"(erasable syntax),否则会报 ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX。
升级前先扫一遍代码库,找这三类写法:
# 扫描需要代码生成的 TypeScript 写法
grep -rn "^\s*enum \|namespace \|constructor(private\|constructor(public" \
--include="*.ts" src/ | head -n 20
扫到了也别慌,有三条出路:改成可擦除写法(enum 改成联合类型加 as const 对象)、继续用 tsc 或 tsx 编译后再跑、或者把这类文件排除在直跑之外。反模式是:升级后才发现启动即崩,然后在生产环境现改代码。
另外注意:node 跑 .ts 时完全不做类型检查,tsc --noEmit 仍要在 CI 里保留;同时 .tsx 不支持、导入必须带文件扩展名,这些限制在 26 里没有变。
附带的好消息:Temporal API 默认开启
Node.js 26 的头条新功能是 Temporal API 默认启用。这是用来替代 Date 的现代日期时间 API,时区和日历处理不再靠第三方库硬凑:
// Node.js 26 可直接运行,无需 flag
const today = Temporal.Now.plainDateISO();
console.log(today.toString()); // 如 2026-11-15
const meeting = Temporal.ZonedDateTime.from(
"2026-11-15T09:00:00+08:00[Asia/Shanghai]"
);
console.log(meeting.add({ hours: 2 }).toString());
TypeScript 6.0 已内置 Temporal 的类型定义。如果你的项目还在用 Date 做跨时区计算,这是一个值得逐步迁移的点;但别在升级同一天顺手重构,先让服务在新版本上稳定跑起来。
升级清单(照着打勾)
1. node -v 确认当前版本线,20 必须升,24/22 先打到 10 月 21 日的补丁版(24.22.1 / 22.23.4)。
2. 全仓扫一遍 enum、namespace、构造函数参数属性,确认没有只能靠 --experimental-transform-types 才能跑的文件。
3. CI 矩阵先加 26 跑一轮,确认测试全绿,再改生产镜像的版本号;别在 Dockerfile 里写 node:latest。
4. tsc --noEmit 保留在 CI 门禁里,类型检查这件事 Node.js 运行时永远不会替你做。
LTS 升级最稳的姿势从来不是追新,而是先把旧账算清:补丁打了没有、语法越界了没有、类型检查还在不在。把这三件核对完,Node.js 26 的三年支持期才真正是你的。
- 点赞
- 收藏
- 关注作者
评论(0)