关于此工具
语义化版本控制规范(Semantic Versioning 2.0.0,简称 SemVer,由 GitHub 联合创始人 Tom Preston-Werner 发起倡议)是现代开源软件工程、npm / Cargo / Maven 包依赖管理系统及 CI/CD 持续发布流水线中通用的版本契约基石。标准语义化版本由三段式主版本号.次版本号.修订号(`MAJOR.MINOR.PATCH`)及可选的先行预发标签(Pre-release,如 `-alpha.1`、`-beta.2`、`-rc.1`)构成。机器比较版本并非简单的浮点数比较(如 `1.10.0` 远大于 `1.9.0`)。本工具提供纯前端 SemVer 规范语法校验、多版本精准比较与版本列表自动升降序排列。
如何使用本工具(操作步骤)
输入待比较的两个版本号
在版本 A 与版本 B 输入框中分别键入待对比的 SemVer 字符串(如 `2.1.0-beta.1` 与 `2.0.9`,支持带不带前缀 `v`)。
实时比对两者的升级演变层级
系统即刻根据 SemVer 2.0.0 规范,毫秒级判定 A 大于、等于还是小于 B,并高亮标出本次升级的具体类型(重大 Major、功能 Minor 还是修补 Patch)。
批量多版本一键排序与导出
亦可在批量模式下粘贴多个杂乱的版本号列表,系统将按照官方标准优先级规则,一键输出升序或降序排列的整洁发版清单。
严格遵循 SemVer 2.0.0 官方优先层级判定准则
严密处理包括先行版本号(Pre-release)优先级比较(`1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0`),无一遗漏。
支持构建元数据 (Build Metadata `+`) 的忽略机制
严格遵循国际标准:带有加号的构建元数据(如 `1.0.0+20130313144700`)在比较版本高低时自动忽略,不影响软件发布优先级。
纯本地离线计算,内部版本规划绝对保密
所有版本解析与比对算法在浏览器本地内存中运行,公司未公开的内部框架秘密发版计划与 Tag 规划绝不外传。
SemVer 版本规划常识与依赖管理避坑指南
- •零号版本时代(`0.y.z`)的特殊免责声明:在软件处于开发初期(`0.x.x`)时,任何东西都可能随时改变!公共 API 不应被视为稳定可靠。只有当软件发布了正式版(`1.0.0`),才正式代表对外确立了严肃的向后兼容性契约!
- •切勿使用普通的数字 `parseFloat` 比较版本:很多新手写出 `parseFloat("1.10")` 与 `parseFloat("1.9")`,会导致 `1.10` 被错误解析为 `1.1`,从而得出“1.9 大于 1.10”的反人类严重 Bug!版本号不是浮点数,每一位必须独立按整数比对!
- •先行发布标签(Pre-release)带点号分割规则:先行标签中,以点号分隔的纯数字段(如 `-alpha.1` 与 `-alpha.2`)按数字大小比对(1 < 2);而字母标识符(如 `-alpha` 与 `-beta`)按 ASCII 字典序比对。
代码与转换对比示例
SemVer 2.0.0 三大核心数字升级语义法则速查表
MAJOR . MINOR . PATCH (例如: 2 . 4 . 1)
↑ ↑ ↑
主版本 次版本 修订号• MAJOR (主版本号) : 当你做了不兼容的 API 破坏性变更 (Breaking Changes) 时必须递增!
• MINOR (次版本号) : 当你做了向下兼容的功能性新增 (New Features) 时必须递增!
• PATCH (修订号) : 当你做了向下兼容的问题修复 (Bug Fixes) 时必须递增!* 当主版本号(MAJOR)递增时,次版本号与修订号必须强制归零(如从 1.8.4 升级为 2.0.0)。
现代 Node.js 使用官方 semver 库比较版本核心代码
const semver = require('semver');
// 比较大小 (gt 代表 greater than)
console.log(semver.gt('1.10.0', '1.9.0')); // true (非浮点比较!)
// 检查先行版本
console.log(semver.lt('2.0.0-rc.1', '2.0.0')); // true (正式版高于预发版)
// 验证范围满足性
console.log(semver.satisfies('1.2.3', '^1.2.0')); // true• ~1.2.3 : 仅允许匹配同一 MINOR 的修复 (>=1.2.3 <1.3.0)
• ^1.2.3 : 允许匹配同一 MAJOR 的功能 (>=1.2.3 <2.0.0,锁定大版本不被破坏)* 现代 `package.json` 默认推荐使用 `^` 前缀以兼顾安全与特性更新。
常见问题解答
Q: 为什么正式版(1.0.0)必须大于它的任何候选预发版(1.0.0-rc.1)?
A: 根据 SemVer 官方第 9 条核心规定:先行版本号表示该版本是不稳定的,可能无法满足预期的兼容性要求。一个带有先行标签的版本,其优先级必然严格低于没有先行标签的同名正式版本。
Q: 版本号前面的前缀 `v`(如 `v1.2.3`)属于 SemVer 规范吗?
A: 严格在 SemVer 2.0.0 规范定义中,版本号必须纯由数字开头,**不包含前缀 `v`**。但由于 Git 传统标签(Git Tag)普遍习惯加上 `v`,本工具在解析时进行了智能兼容,自动脱敏前缀 `v` 进行规范比较。
Q: 支持批量给上百个 Git Release Tags 进行按时间版本排序吗?
A: 完全胜任。在多版本排序模式下粘贴从 Git 仓库终端 `git tag` 导出的上百个版本序列,系统能在数毫秒内将其规整为绝对严谨的 SemVer 降序清单,方便一键编写更新日志(Changelog)。