版本號命名指南

（點選上方公眾號，可快速關註）

來源：koala bear ，

wsfdl.com/devops/2016/09/27/版本號.html

首先看看某些常見軟體的版本號：

• Linux Kernel： 0.0.1，1.0.0，2.6.32，3.0.18…，若用 X.Y.Z 表示，則偶數 Y 表示穩定版本，奇數 Y 表示開發版本。

• Windows：windows 98，windows 2000，windows xp，windows 7…，最大的特點是雜亂無章，毫無規律。

• SSH Client：0.9.8。

• OpenStack：2014.1.3，2015.1.1.dev8。

從上可以看出，不同的軟體版本號風格各異，隨著系統的規模越大，依賴的軟體越多，如果這些軟體沒有遵循一套規範的命名風格，容易造成 Dependency Hell。所以當我們釋出版本時，版本號的命名需要遵循某種規則，其中 Semantic Versioning 2.0.0 定義了一套簡單的規則及條件來約束版本號的配置和增長。本文根據 Semantic Versionning 2.0.0 和 Semantic Versioning 3.0.0 選擇性的整理出版本號命名規則指南。

版本號命名規則指南

版本號的格式為 X.Y.Z(又稱 Major.Minor.Patch)，遞增的規則為：

• X 表示主版本號，當 API 的相容性變化時，X 需遞增。

• Y 表示次版本號，當增加功能時(不影響 API 的相容性)，Y 需遞增。

• Z 表示修訂號，當做 Bug 修複時(不影響 API 的相容性)，Z 需遞增。

詳細的規則如下：

1. X, Y, Z 必須為非負整數，且不得包含前導零，必須按數值遞增，如 1.9.0 -> 1.10.0 -> 1.11.0

2. 0.Y.Z 的版本號表明軟體處於初始開發階段，意味著 API 可能不穩定；1.0.0 表明版本已有穩定的 API。

3. 當 API 的相容性變化時，X 必須遞增，Y 和 Z 同時設定為 0；當新增功能(不影響 API 的相容性)或者 API 被標記為 Deprecated 時，Y 必須遞增，同時 Z 設定為 0；當進行 bug fix 時，Z 必須遞增。

4. 先行版本號(Pre-release)意味該版本不穩定，可能存在相容性問題，其格式為：X.Y.Z.[a-c][正整數]，如 1.0.0.a1，1.0.0.b99，1.0.0.c1000。

5. 開發版本號常用於 CI-CD，格式為 X.Y.Z.dev[正整數]，如 1.0.1.dev4。

6. 版本號的排序規則為依次比較主版本號、次版本號和修訂號的數值，如 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。

7. 註意：版本一經釋出，不得修改其內容，任何修改必須在新版本釋出！

一些修飾的詞

• alpha：內部版本

• beta：測試版

• demo：演示版

• enhance：增強版

• free：自由版

• full version：完整版，即正式版

• lts：長期維護版本

• release：發行版

• rc：即將作為正式版釋出

• standard：標準版

• ultimate：旗艦版

• upgrade：升級版

看完本文有收穫？請轉發分享給更多人

關註「ImportNew」，看技術乾貨