如何编写版本号语义化版本控制规范
· 阅读需 2 分钟
版本号的构成
语义化版本号由三部分组成:主版本号、次版本号和补丁版本号,格式为 X.Y.Z。
主版本号(X):当你做出不兼容的 API 更改时递增这个版本号。不兼容的更改指的是,任何现有用户必须修改其代码才能继续运行的更改,例如重大的重构或功能移除。
次版本号(Y):当你添加了向后兼容的新功能时递增这个版本号。向后兼容意味着旧版本的用户可以安全升级,不会影响现有功能。
补丁版本号(Z):当你进行了向后兼容的问题修正时递增这个版本号。这通常包括对 bug 的修复或安全问题的修复,不改变软件的功能和 API。
版本号的递增规则
版本号需要按顺序递增。如果主版本号增加,次版本号和补丁版本号应重置为 0;如果次版本号增加,补丁版本号应重置为 0。
不必每个版本都发布,可以跳过某些数字,例如从 1.0.0 直接升级到 2.0.0,或者从 1.5.0-beta 直接升级到 1.5.0。
版本控制注意事项
正常版本号如v1.1.1
和1.1.1
更推荐使用前者
如果主版本号没有为 1,那说这个应用可能还没有发布稳定版本,需要注意
每次发布主版本的时候,一般都会提前发布一个beta
版本,等beta
版本稳定了再发布新版本
迭代版本的时候最好使用 CI/CD 工具来代替人为的设置,这样有记录而且更清晰