Node.js 26 进入 Active LTS:升级前先核对的三件事

举报
yd_225649965 发表于 2026/11/15 01:11:48 2026/11/15
【摘要】 Node.js 26 进入 Active LTS:升级前先核对的三件事2026 年 10 月 28 日,Node.js 26.13.0(代号 Lithium)正式成为 Active LTS,支持到 2029 年 4 月 30 日。同一时期,24 和 22 进入维护期,20 彻底结束生命周期。LTS 的意思不是"最新最好",而是"只修 bug 和安全问题,不引入破坏性变更"——生产环境选版本,...

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 的三年支持期才真正是你的。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。