软件版本号命名规则

本文详细解读了语义化版本命名的X.Y.Z规则,包括主次修订号的递增原则,以及商业软件中的不同版本类型和修饰词含义。了解这些有助于开发者更好地管理API版本和软件发布过程。

语义化版本命名通行规则
语义化版本命名通行规则对版本的迭代顺序命名做了很好的规范,其版本号的格式为X.Y.Z(又称Major.Minor.Patch)。

其递增

 

规则如下:

序号    格式要求    说明
X    非负整数    表示主版本号(Major),当API 的兼容性变化时,X 需递增。
Y    非负整数    表示次版本号(Minor),当增加功能时(不影响API 的兼容性),Y 需递增。
Z    非负整数    表示修订号(Patch),当做Bug 修复时(不影响API 的兼容性),Z 需递增。
详细使用规则:

X.Y. Z 必须为非负整数,且不得包含前导零,必须按数值递增,如1.9.0 -> 1.10.0 -> 1.11.0

0.Y.Z 的版本号表明软件处于初始开发阶段,意味着API 可能不稳定;1.0.0 表明版本已有稳定的 API。

当API 的兼容性变化时,X 必须递增,Y 和Z 同时设置为0;当新增功能(不影响API 的兼容性)或者API 被标记为Deprecated 时,Y 必须递增,同时Z 设置为0;当进行bug fix 时,Z 必须递增。

先行版本号(Pre-release)意味该版本不稳定,可能存在兼容性问题,其格式为:X.Y.Z.[a-c][正整数],如1.0.0.a1,1.0.0.b99,1.0.0.c1000。

开发版本号常用于CI-CD,格式为X.Y.Z.dev[正整数],如1.0.1.dev4。

版本号的排序规则为依次比较主版本号、次版本号和修订号的数值,如1.0.0 < 1.0.1 < 1.1.1 < 2.0.0;对于先行版本号和开发版本号,有:1.0.0.a100 < 1.0.0,2.1.0.dev3 < 2.1

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值