Hydrogen 的版本更新与升级要注意什么?
Hydrogen 的版本更新以“补丁版本修问题、次版本加功能、beta 版先预览”为基本节奏。升级前先确认你当前用的是稳定版还是 beta 版，再去看对应版本的发布说明和更新日志，这是避免踩坑的关键。根据 hydrogen-music.org 首页的发布记录，最新补丁版本是 2026 年 10 月 2 日发布的 1.2.7，官方说明它包含少量 bug 修复、翻译更新，并为即将到来的 2.0 版本改进了向前兼容性。
版本号怎么看
Hydrogen 使用三段式版本号（如 1.2.7），可以这样理解：
| 位置 | 含义 | 例子 |
|---|---|---|
| 第一位 | 主版本，可能带来较大变化 | 1.x → 2.0 |
| 第二位 | 次版本，引入新功能 | 1.1 → 1.2 |
| 第三位 | 补丁版本，以修复为主 | 1.2.6 → 1.2.7 |
从首页记录看，1.2.0 于 2023 年 4 月发布，此后陆续推出 1.2.1 到 1.2.7 多个补丁版本，节奏大致是每年一到两次。补丁版本通常不改变使用方式，属于可以放心跟进的更新。
稳定版与 beta 版的区别
- 稳定版：官方明确“推荐所有用户使用”的版本。1.2.0、1.1.1、1.1.0 等发布说明中都出现了这类表述。
- beta 版：用于预览下一个次版本的新功能。例如 1.2.0-beta1 于 2022 年 12 月发布，预览的是 1.2 系列的新特性；1.1.0 beta1 则在 2021 年 4 月发布，同期还庆祝了 Hydrogen 诞生 20 周年。
如果你只是日常使用，选稳定版；想提前体验新功能、并且能接受可能的不稳定，再考虑 beta 版。
升级前建议做的事
- 确认当前版本：先弄清自己装的是哪个版本，才能判断这次升级跨度有多大。
- 查看对应发布说明：每次发布都附有说明和更新日志（Changelog），1.1.0 beta1 的公告里就明确指向 GitHub 上的 Changelog 和下载。升级前读一遍，能知道修了什么、改了什么。
- 留意兼容性提示：1.2.7 的说明特别提到“为即将到来的 2.0 版本改进向前兼容性”。这类信息意味着官方在为跨主版本升级做准备，值得关注。
- 遇到问题去社区：Hydrogen 在 2020 年 12 月启用了 GitHub Discussions 替代旧论坛，用于讨论想法和分享经验。
关于 2.0 的预期
首页记录显示，1.2.7 已经包含面向 2.0 的向前兼容改进。这说明 2.0 是一个正在推进的主版本更新。在主版本发布前，保持使用最新的 1.2.x 补丁版本，是让工程和配置更平滑过渡到 2.0 的稳妥做法。