跳到主要内容

如何编写版本号语义化版本控制规范

· 阅读需 2 分钟
素明诚
Full stack development

版本号的构成

语义化版本号由三部分组成:主版本号、次版本号和补丁版本号,格式为 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.11.1.1更推荐使用前者

如果主版本号没有为 1,那说这个应用可能还没有发布稳定版本,需要注意

每次发布主版本的时候,一般都会提前发布一个beta版本,等beta版本稳定了再发布新版本

迭代版本的时候最好使用 CI/CD 工具来代替人为的设置,这样有记录而且更清晰