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 年。
- 减轻发布人员的负担。
新的发布计划
| 阶段 | 持续时间 | 描述 |
|---|---|---|
| Alpha | 6 个月 | 10 月至 3 月。早期测试,允许 semver-major 变更 |
| Current | 6 个月 | 4 月至 10 月。稳定化 |
| LTS | 30 个月 | 长期支持,提供安全修复 |
| 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 26 时间表(现有模式)
| 里程碑 | 日期 |
|---|---|
| 26.0.0 | 2026 年 4 月 |
| 进入 LTS | 2026 年 10 月 |
| 维护 | 2027 年 10 月 |
| 生命周期结束 | 2029 年 4 月 |
Node.js 26 遵循现有时间表。这是当前模式下的最后一条发布线。
Node.js 27 时间表(新模式)
| 里程碑 | 日期 |
|---|---|
| Alpha 阶段开始 | 2026 年 10 月 |
| 27.0.0 | 2027 年 4 月 |
| 进入 LTS | 2027 年 10 月 |
| 生命周期结束 | 2030 年 4 月 |
Node.js 27 是新时间表下的第一条发布线。
未来 10 年
| 版本 | Alpha | Current | LTS | 生命周期结束 |
|---|---|---|---|---|
| 27.x | 2026 年 10 月 | 2027 年 4 月 | 2027 年 10 月 | 2030 年 4 月 |
| 28.x | 2027 年 10 月 | 2028 年 4 月 | 2028 年 10 月 | 2031 年 4 月 |
| 29.x | 2028 年 10 月 | 2029 年 4 月 | 2029 年 10 月 | 2032 年 4 月 |
| 30.x | 2029 年 10 月 | 2030 年 4 月 | 2030 年 10 月 | 2033 年 4 月 |
| 31.x | 2030 年 10 月 | 2031 年 4 月 | 2031 年 10 月 | 2034 年 4 月 |
| 32.x | 2031 年 10 月 | 2032 年 4 月 | 2032 年 10 月 | 2035 年 4 月 |
| 33.x | 2032 年 10 月 | 2033 年 4 月 | 2033 年 10 月 | 2036 年 4 月 |
| 34.x | 2033 年 10 月 | 2034 年 4 月 | 2034 年 10 月 | 2037 年 4 月 |
| 35.x | 2034 年 10 月 | 2035 年 4 月 | 2035 年 10 月 | 2038 年 4 月 |
| 36.x | 2035 年 10 月 | 2036 年 4 月 | 2036 年 10 月 | 2039 年 4 月 |
该时间表尚未最终确定,可能会修订。如需了解项目支持承诺的最新记录,请参阅 schedule.json。
致谢
这项变更是围绕 GitHub 议题、Release Working Group 会议以及 2025 年切萨皮克协作峰会 展开讨论的结果。 我们将在即将于伦敦举行的协作峰会上继续讨论这一主题。 感谢所有提供反馈的人。
如有问题或意见,请参阅 nodejs/Release#1113。