语义化版本(SemVer)

定义

语义化版本(Semantic Versioning,SemVer)是一套版本号命名规范,通过 主版本号.次版本号.修订号(如 2.4.1)的格式,清晰传达每次发布所包含变更的性质。

规则

在版本号 MAJOR.MINOR.PATCH 中:

• 主版本号(MAJOR):做了不兼容的 API 变更时递增。
• 次版本号(MINOR):以向后兼容的方式新增功能时递增。
• 修订号(PATCH):做了向后兼容的缺陷修复时递增。

此外可用连字符附加先行版本标识(如 1.0.0-alpha),用加号附加构建元数据。

核心思想

SemVer 旨在解决「依赖地狱」。当版本号遵循统一约定,使用者便能根据版本变化判断升级的风险:修订号升级可放心,主版本号升级则需警惕破坏性变更。

实践应用

npm、Cargo 等包管理器广泛采用 SemVer,并支持基于范围的依赖声明(如 ^1.2.3)。0.y.z 表示尚不稳定的初始开发阶段。

价值

SemVer 为依赖管理建立了可预期的契约,让生态系统中的版本协作更加可靠、自动化。