版本管理#

Home Assistant Core 使用 calendar versioning (CalVer)。一个版本由三个用点分隔的部分组成：

YYYY.MM.PATCH

例如，2026.5.0 是 2026 年 5 月的初始发布，而 2026.5.1 和 2026.5.2 是同月的后续 patch releases。关于发布计划和渠道，请参阅 release FAQ。

#预发布版本和开发版本

版本遵循 PEP 440，因此 PATCH 部分可以带有表示非稳定构建的 suffix：

#版本号的设定方式

版本被硬编码在 homeassistant/const.py 中，作为 MAJOR_VERSION、MINOR_VERSION 和 PATCH_VERSION 常量。dev branch 始终将即将到来的发布作为一个 development version（例如 2026.7.0.dev0）。

版本不是自动从 tags 或日期推导出来的；它是通过使用 script/version_bump.py helper 显式 bump 的，该 helper 知道如何推进每种类型的版本（minor、patch、dev、beta 和 nightly）。例如，发布第一个 beta 会将 2026.7.0.dev0 变成 2026.7.0b0，而最终发布则去掉 suffix 变为 2026.7.0。