語意化版本計算

語意化版本號計算與比較,遵循 SemVer 2.0 規範。

版本遞增

主版本(MAJOR)
不相容的 API 變更
次版本(MINOR)
向後相容的功能新增
修訂版本(PATCH)
向後相容的問題修正
預發布標記(快速選擇)
alpha
Alpha
內部測試版,功能不完整,可能存在大量 bug
beta
Beta
公開測試版,功能大致完整,可能存在少量 bug
rc
Release Candidate
發布候選版,功能完整,通過測試後可轉為正式版
dev
Development
開發中版本,不穩定,僅供開發偵錯使用
preview
Preview
預覽版,展示新功能,可能不穩定
pre
Pre-release
預發布版本,泛指任何正式發布前的版本

版本比較

=

版本範圍檢查

SemVer 規範

語意化版本號格式: MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

  • MAJOR — 不相容的 API 變更時遞增
  • MINOR — 向後相容的功能新增時遞增
  • PATCH — 向後相容的問題修正時遞增
  • PRERELEASE — 預發布標記(例如 alpha、beta、rc.1)
  • BUILD — 建置中繼資料(例如 +build.123)

預發布標記詳解

預發布標記以 - 連接在 PATCH 版本號之後,表示版本優先順序低於正式版本。標記內可用 . 分隔多個區段,數字區段依數值比較,字母區段依 ASCII 比較。

標記全名常見用途範例
alphaAlpha內部測試版,功能不完整,可能存在大量 bug1.0.0-alpha
betaBeta公開測試版,功能大致完整,可能存在少量 bug1.0.0-beta.2
rcRelease Candidate發布候選版,功能完整,通過測試後可轉為正式版1.0.0-rc.1
devDevelopment開發中版本,不穩定,僅供開發偵錯使用1.0.0-dev
previewPreview預覽版,展示新功能,可能不穩定1.0.0-preview
prePre-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)對範圍的細節定義可能略有差異,正式環境建議搭配對應工具驗證。