Semver(語義化版本號)掃盲

最近Github 10週年在朋友圈裏沸沸揚揚刷屏，小編在工做中卻驚訝的發現很多同事對版本號中的beta和rc沒有概念，使用npm install package@next時，也不清楚next表明的含義。因而，決定寫一篇文章科普一下由 Github 起草的Semver(語義化版本)的相關知識。

實際案例

首先，咱們來看看目前最流行的前端框架之一的React最近5個月的版本發佈日誌，截圖來自npmjs.com：

從上圖，咱們不可貴出幾個結論：

• 軟件的版本一般由三位組成，形如：X.Y.Z
• 版本是嚴格遞增的，此處是：16.2.0 -> 16.3.0 -> 16.3.1
• 在發佈重要版本時，能夠發佈alpha, rc等先行版本
• alpha和rc等修飾版本的關鍵字後面能夠帶上次數和meta信息

能夠說，React 發佈版本時作的至關到位，版本給人的感受很是清晰，也很嚴謹。這得益於 Semver(語義化版本) 規範的功勞。那麼，Semver是在什麼場景下出現的呢？它的出現又解決了什麼問題？這裏要和你們科普下「依賴地獄」的概念。

依賴地獄

通俗而言，「依賴地獄」指開發者安裝某個軟件包時，發現這個軟件包裏又依賴不一樣特定版本的其它軟件包。隨着系統功能愈來愈複雜，依賴的軟件包愈來愈多，依賴關係也愈來愈深，這個時候可能面臨版本控制被鎖死的風險。

所以，Github 起草了一個具備指導意義的，統一的版本號表示規則，稱爲 Semantic Versioning(語義化版本表示)。該規則規定了版本號如何表示，如何增長，如何進行比較，不一樣的版本號意味着什麼。

官網：semver.org/ 中文版：semver.org/lang/zh-CN/

下面是聽從了Semver規範的React依賴圖，截圖來自npm.broofa.com:

能夠看出，聽從了Semver規範的包依賴很是清晰，沒有出現循環依賴、依賴衝突等常見問題。

版本格式

版本格式：主版本號.次版本號.修訂號，版本號遞增規則以下：

• 主版本號(major)：當你作了不兼容的 API 修改，
• 次版本號(minor)：當你作了向下兼容的功能性新增，能夠理解爲Feature版本，
• 修訂號(patch)：當你作了向下兼容的問題修正，能夠理解爲Bug fix版本。

先行版本號及版本編譯信息能夠加到「主版本號.次版本號.修訂號」的後面，做爲延伸。

先行版本

當要發佈大版本或者核心的Feature時，可是又不能保證這個版本的功能 100% 正常。這個時候就須要經過發佈先行版本。比較常見的先行版本包括：內測版、灰度版本了和RC版本。Semver規範中使用alpha、beta、rc(之前叫作gama)來修飾即將要發佈的版本。它們的含義是：

• alpha: 內部版本
• beta: 公測版本
• rc: 即Release candiate，正式版本的候選版本

好比：1.0.0-alpha.0, 1.0.0-alpha.1, 1.0.0-beta.0, 1.0.0-rc.0, 1.0.p-rc.1 等版本。alpha, beta, rc後須要帶上次數信息。

版本發佈準則

列舉出比較實用的一些規則：

• 標準的版本號必須採用XYZ的格式，而且X、Y 和 Z 爲非負的整數，禁止在數字前方補零，版本發佈須要嚴格遞增。例如：1.9.1 -> 1.10.0 -> 1.11.0。
• 某個軟件版本發行後，任何修改都必須以新版本發行。
• 1.0.0 的版本號用於界定公共 API。當你的軟件發佈到了正式環境，或者有穩定的API時，就能夠發佈1.0.0版本了。
• 版本的優先層級指的是不一樣版本在排序時如何比較。判斷優先層級時，必須把版本依序拆分爲主版本號、次版本號、修訂號及先行版本號後進行比較。

npm包依賴

當執行npm install package -S 來安裝三方包時，npm 會首先安裝包的最新版本，而後將包名及版本號寫入到 package.json 文件中。

好比，經過npm 安裝 react 時：

{
  "dependencies": {
    "react": "~16.2.0"
  }
}
複製代碼

項目對包的依賴可使用下面的 3 種方法來表示(假設當前版本號是 16.2.0):

• 兼容模塊新發布的補丁版本：~16.2.0、16.2.x、16.2
• 兼容模塊新發布的小版本、補丁版本：^16.2.0、16.x、16
• 兼容模塊新發布的大版本、小版本、補丁版本：*、x

npm包發佈

一般咱們發佈一個包到npm倉庫時，咱們的作法是先修改 package.json 爲某個版本，而後執行 npm publish 命令。手動修改版本號的作法創建在你對Semver規範特別熟悉的基礎之上，不然可能會形成版本混亂。npm 考慮到了這點，它提供了相關的命令來讓咱們更好的聽從Semver規範：

• 升級補丁版本號：npm version patch
• 升級小版本號：npm version minor
• 升級大版本號：npm version major

當執行 npm publish 時，會首先將當前版本發佈到 npm registry，而後更新 dist-tags.latest 的值爲新版本。

當執行 npm publish --tag=next 時，會首先將當前版本發佈到 npm registry，而且更新 dist-tags.next 的值爲新版本。這裏的 next 能夠是任意有意義的命名（好比：v1.x、v2.x 等等）

OK，如今你應該知道 npm install package@next時next表明的含義了吧！

---

《IVWEB 技術週刊》 震撼上線了，關注公衆號：IVWEB社區，每週定時推送優質文章。

• 週刊文章集合: weekly
• 團隊開源項目: Feflow