版本号的规范

语义化版本号规范链接:https://semver.org/lang/zh-CN/

参考链接:https://blog.csdn.net/u012107143/article/details/78731272
https://blog.csdn.net/qq_38880380/article/details/79319126

整理:草梅友仁

注:草梅在整理的过程中发现两篇文章还是有较大差异的,不过意思是差不多的,只要理解一下就行。

前言

版本号是一个很重要的东西。搞明白版本号问题,对于开发者和用户都有很大的帮助

  1. 对开发者
    • 版本号的命名和更新问题,是开发者的责任感和前瞻性的问题,一个规范的版本号,能够帮助用户正确理解你开发的程序,以及优化用户体验
  2. 对用户
    • 明白版本号规范之后,就能找到对应的教程和文档,才不至于在使用中摸不着头脑
  • 另外也要说一句,IT 界日新月异,网上的资料很有可能已经是过时的,因此,在找到时间较早、距离现在时间已经比较久的资料时,一定要注意版本号问题

版本号规范

  1. 版本格式:主版本号.子版本号.阶段版本号,版本号递增规则如下:

  • 主版本号:全盘重构时增加;重大功能或方向改变时增加;大范围不兼容时增加;当产生了严重影响项目的修改时增加。

  • 子版本号:增加新的业务功能,并且向下兼容的更新时增加

  • 阶段版本号:一般是 Bug 修复或是一些小的变动,要经常发布修订版,时间间隔不限,修复一个严重的 bug 即可发布一个修订版。修复 BUG、以及一些细节上的更新时增加(没有产生新业务功能,仅在原来的上面修订时都可以增加)

  1. 也可以在三位的基础上再加一位日期版本号希腊字母版本号

    • 日期版本号:用于记录修改项目的当前日期,每天对项目的修改都需要更改日期版本号。此版本号由开发人员决定是否修改。(例如 20190513)
  • 希腊字母版本号:此版本号用于标注当前版本的软件处于哪个开发阶段,当软件进入到另一个阶段时需要修改此版本号。此版本号由项目决定是否修改。希腊字母版本号共有 5 种,分别为:base、alpha、beta、RC、release。(例如:4.0.0_beta)
    • α(Alpha)版:内测版。此版本表示该软件在此阶段主要是以实现软件功能为主,通常只在软件开发者内部交流,或者专业测试人员测试用,一般而言,该版本软件的 Bug 较多,需要继续修改。
    • β(Beta)版:公测版。该版本相对于α版已有了很大的改进,消除了严重的错误,但还是存在着一些缺陷,需要经过多次测试来进一步消除,此版本主要的修改对像是软件的 UI,供专业爱好者大规模测试用。
    • RC 版:是 Release Candidate 的缩写,意思是发布倒计时,候选版本,该版本已经相当成熟了,完成全部功能并清除大部分的 BUG,基本上不存在导致错误的 BUG,与即将发行的正式版相差无几。
    • Release 版:该版本意味“最终版本”,在前面版本的一系列测试版之后,终归会有一个正式版本,是最终交付用户使用的一个版本。该版本有时也称为标准版。一般情况下,Release 不会以单词形式出现在软件封面上,取而代之的是符号(R)。
  1. 除此之外

    • 先行版本号(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.0;当存在字母时,以 ASCII 的排序来比较,如 1.0.0.a1 < 1.0.0.b1。

后记

草梅之所以会如此在意版本号的问题,也是因为在版本号上栽过跟头。

之前在开发的时候还没注意过版本号的规范,于是就想当然的来了,结果就发现自己的版本号命名是不符合规范的,造成什么误解也是不奇怪的。

而作为用户,要举的例子就是 webpack 这个前端打包神器。目前它的版本已经到了 4.x,而我在网上找的教程、别人写的博客等都还是 3.x 的,遇到问题也是因为版本号不同。从 3.x 到 4.x,显然其中是有不兼容更新的,不然它也没必要增加一位主版本号。

而且作为一个工具,webpack 上还有很多插件,显然,当 webpack 更新时,这些插件也得跟着更,其中有一个插件就是"extract-text-webpack-plugin",直接下载的话它是 3.x 版本,不支持 webpack4.x 版本,只能指定版本号为 4.0.0-beta.0 才行

所以一定要再三注意版本号问题!