跳到主要内容

Node.js 发布计划的演进

Node.js Releasers

从 27.x 开始,Node.js 将从每年发布两个主版本改为一个。 本文解释了将发生哪些变化、为何发生变化,以及这对用户意味着什么。关于 完整讨论和背景,请参阅 nodejs/Release#1113。

摘要: 如果你已经只升级到 LTS 版本,那么除了 版本编号之外几乎没有什么变化。LTS 支持周期大致保持不变,而且现在每个版本 都会成为 LTS。

库作者: 请尽可能早地将 Alpha 版本纳入你们的 CI; 如果你们只在 LTS 版本上进行测试,就无法在它们 影响用户之前报告这些缺陷。

为何做出此变更

当前的发布计划已有 10 年历史。它是在 io.js 合并期间制定的,用以平衡不断增长的生态系统的需求。正如一位贡献者当时 所说,这是“对企业需求的有根据的猜测。”

如今,我们掌握了十年的数据,显示人们实际是如何使用 Node.js 的:

  • 奇数版本采用率极低。大多数用户会等待 Long-Term Support。
  • 奇数/偶数版本的区分让新手感到困惑。
  • 许多组织完全跳过奇数版本,只升级到 LTS 版本。

我们也认识到企业需要可预测性。新的发布计划 旨在定义明确,以便团队规划升级并分配资源, 据此做出相应安排。

志愿者可持续性

Node.js 主要由志愿者维护。虽然部分贡献者获得赞助,但大部分 工作(审查 Pull Requests、处理安全问题、制作发布 版本、向后移植修复)都是由人们在业余时间完成的。

跨四到五条活跃发布线管理安全发布已经变得 难以持续。每增加一条发布线,都会提高向后移植的复杂度。通过 减少并发发布线的数量,我们可以专注于更好地 支持人们实际使用的版本。

将发生哪些变化

自 2026 年 10 月起:

  • 每年发布一个主版本 (4 月),并于 10 月进行 LTS 晋级。
  • 每个版本都会成为 LTS。不再有奇数/偶数之分 - Node.js 27 将成为 LTS。
  • 用于早期测试的 Alpha 渠道,允许 semver-major 变更。
  • Alpha 版本编号遵循 semver 预发布格式 (例如 27.0.0-alpha.1)。
  • 版本编号与其初始 Current 发布所在的日历年一致: 27.0.0 对应 2027 年,28.0.0 对应 2028 年。
  • 减轻发布人员的负担。

新的发布计划

阶段持续时间描述
Alpha6 个月10 月至 3 月。早期测试,允许 semver-major 变更
Current6 个月4 月至 10 月。稳定化
LTS30 个月长期支持,提供安全修复
EOL无限期项目不再提供任何支持

总支持周期:从首个 Current 版本发布到 End of Life (EOL) 共 36 个月。

关于 Alpha 渠道

Alpha 渠道填补了奇数版本曾经承担的早期测试角色, 但有一个关键区别:在 Alpha 期间允许 semver-major 变更。

Alpha 版本会进行签名、打标签,并通过 CITGM 进行测试。CITGM (Canary in the Goldmine) 是我们 维护的一个工具,它会在 Node.js 即将发布的 版本上运行主要开源软件包的测试套件,这使我们能够检测生态系统破坏,并在发布前通知 软件包作者。

这与 Nightly builds 不同,后者仍然 作为来自 main 的自动化、未经测试的构建提供 – Alpha 版本可能不包含来自 main 的所有变更,如果符合以下情况,某项变更可能不会被纳入 Alpha 版本:

  • 在 Pull Request 审查期间,审查者添加一个标签,要求不要回移植该变更 (例如,如果某项 API 在 Alpha 版本中被标记为运行时弃用,那么实际移除 该 API 的变更在下一个版本线之前不应合入)。
  • 在 Alpha 版本准备期间,发布者最终决定哪些提交实际进入 发布版本(例如,如果某项依赖项更新包含重大 bug)。

适用对象: 库作者和 CI 流水线,用于测试与 即将到来的破坏性变更的兼容性。不适用于生产环境使用。

预期情况:

  • 版本会进行签名和打标签(与 nightly 不同)。
  • API 可能在不同版本之间发生变化。
  • 发布节奏是灵活的;Release Team 将根据变更量和项目需求确定 Alpha 版本的 发布时间和频率。

原因: 提供对破坏性变更的早期反馈,并具备 Nightly builds 所缺少的 质量门禁。还允许在周期中更早地落地 V8 更新。

在 Alpha 版本中发布 semver-major 提交的规则将由 Release Team 定义,并记录在 Release repository 中。

未发生变化的内容

  • 长期支持时长基本保持不变(30 个月)。
  • 迁移窗口保持不变。LTS 各版本之间仍有重叠期。
  • 质量标准不变。相同的测试、相同的 CITGM、相同的安全流程。
  • 可预测的时间表。4 月发布,10 月晋级为 LTS。
  • V8 采用周期。Node.js 的最新版本仍将包含发布不超过约 6 个月的 V8 版本。

时间线

新的 Node.js 发布时间表

Node.js 26 时间表(现有模式)

里程碑日期
26.0.02026 年 4 月
进入 LTS2026 年 10 月
维护2027 年 10 月
生命周期结束2029 年 4 月

Node.js 26 遵循现有时间表。这是当前模式下的最后一条发布线。

Node.js 27 时间表(新模式)

里程碑日期
Alpha 阶段开始2026 年 10 月
27.0.02027 年 4 月
进入 LTS2027 年 10 月
生命周期结束2030 年 4 月

Node.js 27 是新时间表下的第一条发布线。

未来 10 年

版本AlphaCurrentLTS生命周期结束
27.x2026 年 10 月2027 年 4 月2027 年 10 月2030 年 4 月
28.x2027 年 10 月2028 年 4 月2028 年 10 月2031 年 4 月
29.x2028 年 10 月2029 年 4 月2029 年 10 月2032 年 4 月
30.x2029 年 10 月2030 年 4 月2030 年 10 月2033 年 4 月
31.x2030 年 10 月2031 年 4 月2031 年 10 月2034 年 4 月
32.x2031 年 10 月2032 年 4 月2032 年 10 月2035 年 4 月
33.x2032 年 10 月2033 年 4 月2033 年 10 月2036 年 4 月
34.x2033 年 10 月2034 年 4 月2034 年 10 月2037 年 4 月
35.x2034 年 10 月2035 年 4 月2035 年 10 月2038 年 4 月
36.x2035 年 10 月2036 年 4 月2036 年 10 月2039 年 4 月

该时间表尚未最终确定,可能会修订。如需了解项目支持承诺的最新记录,请参阅 schedule.json。

致谢

这项变更是围绕 GitHub 议题、Release Working Group 会议以及 2025 年切萨皮克协作峰会 展开讨论的结果。 我们将在即将于伦敦举行的协作峰会上继续讨论这一主题。 感谢所有提供反馈的人。

如有问题或意见,请参阅 nodejs/Release#1113。