語意化版本計算
語意化版本號計算與比較,遵循 SemVer 2.0 規範。
版本遞增
版本比較
版本範圍檢查
SemVer 規範
語意化版本號格式: MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
- MAJOR — 不相容的 API 變更時遞增
- MINOR — 向後相容的功能新增時遞增
- PATCH — 向後相容的問題修正時遞增
- PRERELEASE — 預發布標記(例如 alpha、beta、rc.1)
- BUILD — 建置中繼資料(例如 +build.123)
預發布標記詳解
預發布標記以 - 連接在 PATCH 版本號之後,表示版本優先順序低於正式版本。標記內可用 . 分隔多個區段,數字區段依數值比較,字母區段依 ASCII 比較。
| 標記 | 全名 | 常見用途 | 範例 |
|---|---|---|---|
alpha | Alpha | 內部測試版,功能不完整,可能存在大量 bug | 1.0.0-alpha |
beta | Beta | 公開測試版,功能大致完整,可能存在少量 bug | 1.0.0-beta.2 |
rc | Release Candidate | 發布候選版,功能完整,通過測試後可轉為正式版 | 1.0.0-rc.1 |
dev | Development | 開發中版本,不穩定,僅供開發偵錯使用 | 1.0.0-dev |
preview | Preview | 預覽版,展示新功能,可能不穩定 | 1.0.0-preview |
pre | Pre-release | 預發布版本,泛指任何正式發布前的版本 | 1.0.0-pre.1 |
優先順序排序: alpha < beta < rc < 正式版 (例如 1.0.0-alpha < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0)
範圍語法
^1.2.3— 相容 1.2.3(≥1.2.3、<2.0.0)~1.2.3— 近似 1.2.3(≥1.2.3、<1.3.0)>=1.0.0 <2.0.0— 區間範圍1.x— 萬用字元(≥1.0.0、<2.0.0)
使用說明
功能介紹
語意化版本計算工具遵循 SemVer 2.0 規範,支援版本號解析、主/次/修訂版本遞增預覽與一鍵升級、預發布標記快速選擇(alpha/beta/rc/dev/preview/pre,點選即寫入版本號並支援序號遞增)、兩個版本號大小比較,以及 ^/~/>= 等常見版本範圍運算式驗證,方便 npm、Cargo 等套件管理情境快速判斷版本關係。
操作步驟
在「目前版本」輸入框輸入 MAJOR.MINOR.PATCH 格式的版本號,下方會顯示拆解後的主/次/修訂版本與三種遞增預覽,點選對應卡片即可一鍵升級;如需附加預發布標記,可點選「預發布標記」區域的快速按鈕(alpha/beta/rc/dev/preview/pre),點選後會自動將標記寫入版本號,再次點選同一標記會自動遞增序號(例如 alpha → alpha.1 → alpha.2);也可在「自訂預發布標記」輸入框中手動輸入後按 Enter 或點選「新增預發布」;在「版本比較」中輸入兩個版本號即可得知大小關係;在「版本範圍檢查」中輸入版本與範圍運算式(例如 ^1.2.0)即可判斷是否在範圍內。
範圍語法說明
^1.2.3 代表相容版本,允許同主版本下的任意升級(≥1.2.3 且 <2.0.0);~1.2.3 代表近似版本,僅允許同次版本升級(≥1.2.3 且 <1.3.0);>=1.0.0 <2.0.0 代表區間範圍;1.x 為萬用字元寫法。預發布版本(帶有 -alpha 等標記)的優先順序低於正式版本。
注意事項
本工具實作的是簡化版 SemVer 比較,build 中繼資料(+build.123)僅作解析、不參與比較;複雜範圍運算式(例如 || 或組合)暫不支援;版本號必須為 X.Y.Z 三段數字格式,否則會被判定為不合法;不同套件管理員(npm、pip、cargo)對範圍的細節定義可能略有差異,正式環境建議搭配對應工具驗證。
同類工具
同一個分類下還有這些 · 開發工具