底層運作原理
底層直接載入 npm 生態系標準的 `semver` 套件,讓您在瀏覽器獲得與 `npm install` 完全一致的規則判斷。輸入版本範圍表達式(如 `^1.2.0 || ~2.0.1`)與候選版本清單後,工具會精確標示每個版本是否符合條件(特別體現 `^0.2.3` 等同於 `>=0.2.3 <0.3.0` 的 0.x 特殊規範,以及依 SemVer §10 忽略 `+build` 建置中繼資料的規則),並列出最小與最大滿足版本。
詳細操作步驟
在範圍欄位輸入 `package.json` 中的版本條件(如 `^1.2.3`、`~0.4.1` 或 `1.0.0 - 2.5.0`)。
貼入一組待測試的套件版本號清單,並依需求切換「包含先行版(includePrerelease)」開關。
即時檢視每個版本的命中狀態、正規化範圍,以及 `minSatisfying` 與 `maxSatisfying` 結果。
在「比較與遞增」分頁中輸入兩個版本進行 `compare` / `diff` 比較,或預覽 `patch` / `minor` / `major` / `prerelease` 升級後的版號。
核心功能與效能優勢
- 採用官方標準 `semver` 函式庫,判斷邏輯與 Node.js / npm 完全一致
- 完整測試 `^`、`~`、`>=`、`||` 與區間連字號(Hyphen Ranges)及 `0.x.y` 開發版特殊插入符行為
- 支援 `includePrerelease` 先行版開關(測試 `-alpha`、`-beta`、`-rc` 是否被範圍納入)
- 提供 `minSatisfying`、`maxSatisfying`、`semver.compare`、`diff` 與版本遞增預覽
- 100% 瀏覽器本地運行,內部私有套件版本清單不需傳送至任何遠端服務
運算方法、公式與技術標準
所有範圍解析與版本運算皆直接呼叫 npm `semver` 套件的 `satisfies`、`validRange`、`minSatisfying`、`maxSatisfying`、`compare`、`diff` 與 `inc` 方法執行,並嚴格遵循 SemVer 2.0.0 第 10 條規範在比較優先權時忽略 `+build` 建置後綴。
常見實務應用情境
- 前端工程師在更新 `package.json` 前確認 `^0.x.y` 是否會在自動安裝時拉到破壞性改版
- 套件維護者檢查發布 `-rc.1` 先行版本時,既有使用者的 `^1.0.0` 範圍是否會意外升級
- CI/CD 與發行腳本設計時確認 `semver.inc` 從 `1.2.3-alpha.1` 推進到 `prerelease` 或 `patch` 的預期輸出
- 釐清多個連字號區間或 `||` 聯集條件在邊界版本上的實際涵蓋範圍
實作範例與邊界案例
Zero-Major Caret Behavior
Range: ^0.2.3 | Candidates: 0.2.9, 0.3.0
Matches: 0.2.9 (maxSatisfying) | Excluded: 0.3.0
In `0.x.y`, caret locks the minor digit because breaking changes happen in minor bumps.
Prerelease Precedence
Left: 1.4.2 | Right: 1.5.0-rc.1
1.4.2 is older than 1.5.0-rc.1 (diff: premajor/preminor)
Prerelease comes before `1.5.0` final, after `1.4.2`.
使用限制與精準度說明
- • 完全遵循 SemVer 2.0.0 與 npm 語法,不適用 Python PEP 440(如 `~=`)或 Maven 版本比較規則。
- • 僅針對您輸入的版本清單離線驗算,不會主動連線至遠端 npm Registry 查詢線上最新套件版本。
瀏覽器本地運算與隱私保障
傳統線上轉換網站會將您的文件、文字片段或影音檔案上傳至遠端伺服器。SemVer 語意化版本與 npm 範圍測試器 完全在您的瀏覽器分頁內運行:
您的檔案與文字都在裝置本機計算,不會傳送內容至任何後端伺服器。
Microdeck 不會記錄或儲存您在工具內貼上的任何檔案或程式碼。
所有暫存結果僅存在目前分頁記憶體中,重設或關閉分頁後即刻清除。
常見問題 (FAQ)
為什麼 `^0.2.3` 不會匹配 `0.3.0`,但 `^1.2.3` 會匹配 `1.3.0`?
依照 SemVer 與 npm 規定,主版號為 0(`0.x.y`)代表處於初始開發階段,次版號就可能包含破壞性變更,因此 `^0.2.3` 僅允許修補版升級至 `<0.3.0`。
什麼時候需要開啟「包含先行版(includePrerelease)」?
預設情況下,`^1.0.0` 不會匹配像 `1.2.0-beta.1` 這類先行版本,除非該條件的同組元已經明確寫出先行標籤或您開啟了這個開關。
版本號後面的 `+build.123` 會影響比較大小嗎?
不會。根據 SemVer 2.0.0 第 10 條標準,建置中繼資料(`+` 後方文字)在判斷版本優先順序時會被完全忽略。
工具會從網路抓取我們公司的私有套件資訊嗎?
不會,本工具完全離線運作於您的瀏覽器中,不對任何套件庫或伺服器發出請求。