Node.js 26 与 27 时代:Temporal、V8 14.6 与实际升级路径
Node.js 的版本节奏在 2026 年进入了一个新的阶段。截至 2026 年 11 月,LTS 线是 26.x 'Lithium'(当前 26.13.1,2026-11-11)、24.x 'Krypton'(24.22.3)与 22.x 'Jod'(22.23.5),而 27.0.0-alpha 已经在推进。对业务团队来说,值得认真评估的不是"最新号",而是 Node 26 带来的几个默认行为变化:Temporal API 默认启用、V8 升到 14.6、Undici 8,以及一批彻底清退的旧 API。
一、Temporal 终于默认可用
Node 26(2026-05-05 发布的 26.0.0)把 Temporal 从 flag 后面搬了出来,默认启用。这是过去十年 JavaScript 日期时间处理最重要的一次补票:Date 的月份零基、可变性、跨时区语义模糊全部有了替代品。
const dt = Temporal.Now.plainDateTimeISO("Asia/Shanghai");
const zdt = Temporal.Now.zonedDateTimeISO("America/New_York");
// DST 安全的加法:日历日加一天,而不是 24 小时
const tomorrow = zdt.date.add({ days: 1 }).toZonedDateTime();
// 区间与周期是值类型,直接参与业务计算
const period = zdt.until(Temporal.Now.zonedDateTimeISO("America/New_York"));
console.log(period.total({ unit: "hours" }));
迁移建议按依赖面排序:先把新代码统一切到 Temporal;老代码里 date-fns/dayjs 的调用点不必一次换完,但跨时区排班、账单周期这类逻辑优先重写——这是 Date 语义最容易出错的地方。注意 Temporal 由 Rust 实现的 V8 内置提供,构建产物体积略增,浏览器侧则还要看运行时支持矩阵。
二、V8 14.6:Upsert 与 Iterator.concat
Node 26 的 V8 升到 14.6.202.33(对应 Chromium 146),带来两个可直接改善日常代码的语言提案:
// Upsert:Map 的"没有就算一个塞进去",告别 get-then-set 两步
const cache = new Map();
const entry = cache.getOrInsertComputed(url, () => fetchDoc(url));
// Iterator.concat:惰性迭代器拼接,不物化数组
const all = Array.from([1, 2].concatIterator?.([3]) ?? Iterator.concat([1, 2], gen()));
getOrInsertComputed 对缓存层是实质简化:旧写法要先 has 再 set,异常路径下还容易留下半初始化状态。Iterator.concat 则是惰性的——拼接大生成器不会先吃掉内存,适合流式管道。
同时 Node 26 清理了一批 EOL API:http.Server.prototype.writeHeader() 彻底移除(用 writeHead())、_stream_* 系列内部模块移除、module.register() 进入运行时弃用倒计时。升级前先跑一遍 node --pending-deprecation,把 DEP0182/DEP0201/DEP0203/DEP0204 相关调用清掉。
三、Undici 8 与 HTTP 客户端行为
内置 fetch/HTTP 客户端 Undici 升到 8.0.2。对使用 globalThis.fetch 的服务间调用,主要收益是连接复用策略与超时语义的收敛;需要精细控制时用 --import 挂 dispatcher:
// bootstrap.js
import { setGlobalDispatcher, Agent } from "undici";
setGlobalDispatcher(new Agent({
connections: 128,
pipelining: 2,
bodyTimeout: 10_000,
headersTimeout: 5_000,
}));
生产上最常见的坑仍然是没有超时:fetch 默认无 bodyTimeout,对端慢速响应会把连接一直占住。升级到 Undici 8 后这类问题不会自动消失,显式超时仍是必选项。
四、权限模型与安全基线
从 Node 24 起 Permission Model 的 flag 简化为 --permission,配合 --allow-fs-read、--allow-net 等细粒度开关;Node 26 继续收紧默认行为(Linux 构建启用 PIE、macOS 产物开始公证)。对跑多租户脚本的平台(CI runner、在线判题、FaaS),这套内置沙箱已经可以替代大部分"容器里再套 vm2"的方案:
node --permission --allow-fs-read=./src --allow-fs-write=./out --allow-net=api.okgoes.com app.js
另外 Node 26 默认启用了 V8 的 ML-KEM/ML-DSA 后量子密钥导出为 seed-only 格式,如果你的系统在做密钥归档与跨版本恢复,要重新核对导出格式。
五、升级路径怎么排
- 先升 24 → 26 而非一步到 27:26 已进入 LTS(代号 Lithium),24 'Krypton' 的维护窗口也在收紧;
- 兼容性检查三件套:
node --pending-deprecation、npx eslint-plugin-n(按目标 Node 版本查 API)、原生模块重编译(NODE_MODULE_VERSION 从 137 跳到 147,所有 C++ addon 必须重编); - CI 矩阵加一列
26.x,跑一周绿了再把生产镜像换掉; - 观察项:GC 停顿分布(V8 堆扫描策略有变)、fetch 连接池指标、Temporal 相关新代码的时区正确性测试。
小结
Node 26 是那种"没有惊艳特性、但把债还掉了"的版本:Temporal 默认启用终结了日期时间库混战,V8 14.6 的 Upsert/Iterator.concat 直接改善缓存与流式代码,Undici 8 收敛 HTTP 行为,同时一批旧 API 正式退场。升级的主要风险不在新特性,而在 NODE_MODULE_VERSION 跳版导致的原生模块重编与弃用清单。按"24 → 26 LTS、CI 双列并行一周"的节奏走,成本可控。
评论(0)
登录 后参与评论。