首页/开发/Git 与协作速查/Semantic Versioning 语义化版本

Semantic Versioning 语义化版本

版本号含义约定:MAJOR.MINOR.PATCH;不兼容改动升主版本、兼容新增升次版本、兼容修复升修订号。

Git 与协作速查开发更新于 2026-10-12
规则不兼容→MAJOR;兼容新增→MINOR;兼容修复→PATCH
载体标签 vX.Y.Z(附注标签建议)
配套变更说明与升级注意事项

示例

示例
1.4.2  → 修复版本
1.5.0  → 兼容新增
2.0.0  → 不兼容变更
git tag -a v2.0.0 -m 'BREAKING: new auth protocol'
SemVer 2.0.0 是公开发布的规范文档,可作为团队版本号规则的引用基线。

易错点

  • 0.y.z 阶段规则从宽,1.0.0 起按正式约定执行,依赖管理要区分对待
  • 内部依赖与外部契约混用同一套版本号时,升级策略要写清楚

数据来源与参考

  • Semantic Versioning 2.0.0(semver.org)
  • Conventional Commits 1.0.0(版本提升关联说明)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌