網站導覽
目錄
關於語意版本控制
目錄
為了讓 JavaScript 生態系統保持健康、可靠和安全，每次對您擁有的 npm 套件進行重大更新時，我們建議在 package.json 檔案 中發佈一個新版本的套件，其中包含符合 語意版本規格 的更新版本號碼。遵循語意版本規格有助於依賴您的程式碼的其他開發人員了解特定版本中變更的範圍，並在必要時調整他們自己的程式碼。
注意：如果您引入會中斷套件依賴關係的變更，我們強烈建議遞增版本主要號碼；請參閱下方詳細資訊。
遞增已發佈套件中的語意版本
為了幫助依賴您的程式碼的開發人員，我們建議將您的套件版本從 1.0.0 開始，並按以下方式遞增
| 程式碼狀態 | 階段 | 規則 | 範例版本 |
|---|---|---|---|
| 首次發布 | 新產品 | 從 1.0.0 開始 | 1.0.0 |
| 向下相容的錯誤修正 | 修補程式發布 | 遞增第三位數字 | 1.0.1 |
| 向下相容的新功能 | 次要發布 | 遞增中間數字，並將最後一位數字重設為零 | 1.1.0 |
| 會破壞向下相容性的變更 | 主要發布 | 遞增第一位數字，並將中間和最後一位數字重設為零 | 2.0.0 |
使用語意版本來指定套件可以接受的更新類型
您可以在套件的 package.json 檔案中指定套件可以從相依性接受哪些更新類型。
例如，若要指定可接受的版本範圍最高到 1.0.4，請使用下列語法
- 修補程式發布：
1.0或1.0.x或~1.0.4 - 次要發布：
1或1.x或^1.0.4 - 主要發布：
*或x
有關語意版本語法的更多資訊，請參閱 npm semver 計算器。
範例
"dependencies": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
