什么是“语义化版本”?
语义化版本(Semantic Versioning,缩写成 SemVer)是一种软件版本号规范,它的发明者是 GitHub 的创办者 Tom Preston Werner 先生。语义化版本号可以直观反映出某个软件的各个版本之间的兼容性,从而帮助您选取合适的版本。
语义化版本的规范
语义化版本形如 X.Y.Z
。其中,X、Y、Z 三者都是自然数。
- “X”是大版本(Major Version)。当 X 每次自增时,表示该软件做了不能向下兼容的修改,如删除或修改库中的一个或多个函数。举例: v4.0.0 版本和 v3.0.0 版本互不兼容。此外,当 X 为 0 时,表示这个软件处于内测阶段,尚未发行第一个稳定的版本。
- “Y”是小版本(Minor Version),它的值每次自增时,表示该软件做了向下兼容的修改,如一个库中新增了函数等。如 v2.2.5 可以向下兼容 v2.1.3 而不应该出现错误。
- “Z”是修订版本(Patch Version),它的值每次自增时,表示该软件的功能未做任何的增加、修改或删除,只修复了 bug。如某软件的 v5.3.6 和 v5.3.10 版本是可以相互兼容的。
注意
- X 和 Y 是必不可少的,但 Z 可以省略。如“v7.4.15”可以简写成“v7.4”。
- 当 X 为 0 时,要求 Y 的最小值为 1,即最小版本号为 v0.1.0。当推出第一个正式版本后,X 的值增加到 1,此时 Y 的最小值可以为 0,如 v1.0.0 是合法的。
- 每次当 X 自增后,Y 和 Z 都要归零。每次当 Y 自增后,Z 要归零。
伪代码表示
if 删除或改动了已有的功能
x++
y = 0
z = 0
else if 添加了新功能
y++
z = 0
else
z++
end