3. 版本号规范：语义化版本控制（SemVer）详解

在制品管理与回滚体系中，版本号是唯一标识制品状态的“数字指纹”。语义化版本控制（Semantic Versioning，简称 SemVer）是目前业界最广泛采用的版本号规范，它通过 主版本号.次版本号.补丁号 的三段式结构，清晰传达每次变更的兼容性与影响范围。

3.1 SemVer 三段式结构

一个标准的语义化版本号格式为：MAJOR.MINOR.PATCH，例如 2.5.1。每一段数字都对应特定的变更类型：

3.2 版本号递增规则详解

每次发布新制品时，必须根据变更类型严格递增对应的段位，并重置右侧所有段位为 0：

• 主版本号递增（MAJOR）：当进行了不兼容的 API 修改、架构重构、协议变更或重大功能重写时，递增主版本号。例如从 1.3.2 变为 2.0.0。次版本号和补丁号归零。
• 次版本号递增（MINOR）：当新增了向下兼容的新功能、新接口或新能力时，递增次版本号。例如从 1.3.2 变为 1.4.0。补丁号归零。
• 补丁号递增（PATCH）：当进行了向下兼容的缺陷修复、性能优化或安全补丁时，递增补丁号。例如从 1.3.2 变为 1.3.3。

3.3 预发布版本与构建元数据

SemVer 还支持在正式版本号后附加预发布标识和构建元数据，用于标记非稳定版本或构建环境信息：

• 预发布版本：在补丁号后添加连字符和标识符，如 1.0.0-alpha.1、2.3.0-rc.2。预发布版本优先级低于正式版本，常用于内测、灰度或候选发布。
• 构建元数据：在版本号后添加加号和标识符，如 1.0.0+build.20250315。构建元数据不影响版本优先级，仅用于记录构建信息。

3.4 版本号比较与优先级

在制品回滚场景中，版本号的比较直接决定回滚目标的选择。SemVer 的优先级规则如下：

1. 比较主版本号、次版本号、补丁号，按数值从大到小排序。
2. 正式版本优先级高于任何预发布版本（如 1.0.0 > 1.0.0-rc.1）。
3. 预发布版本之间按标识符逐段比较：数字标识符按数值比较，字母标识符按字典序比较。
4. 构建元数据不参与优先级比较，仅作为附加信息。

3.5 版本号规范在制品回滚中的价值

严格执行 SemVer 规范，能为制品回滚和版本冻结带来以下核心收益：

• 明确回滚边界：通过主版本号判断是否可安全回滚，避免跨不兼容版本的回滚导致系统故障。
• 自动化决策依据：CI/CD 流水线可根据版本号自动选择回滚目标，无需人工判断。
• 版本冻结可追溯：冻结策略可以基于版本号范围定义，如“冻结所有 2.x.x 版本”，清晰且可执行。
• 降低沟通成本：开发、测试、运维团队通过版本号即可理解变更影响范围。