T工具箱
1.2.3

SemVer 版本比较

按语义化版本规则排序与比较

关于此工具

语义化版本控制规范(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 规范语法校验、多版本精准比较与版本列表自动升降序排列。

如何使用本工具(操作步骤)

1

输入待比较的两个版本号

在版本 A 与版本 B 输入框中分别键入待对比的 SemVer 字符串(如 `2.1.0-beta.1` 与 `2.0.9`,支持带不带前缀 `v`)。

2

实时比对两者的升级演变层级

系统即刻根据 SemVer 2.0.0 规范,毫秒级判定 A 大于、等于还是小于 B,并高亮标出本次升级的具体类型(重大 Major、功能 Minor 还是修补 Patch)。

3

批量多版本一键排序与导出

亦可在批量模式下粘贴多个杂乱的版本号列表,系统将按照官方标准优先级规则,一键输出升序或降序排列的整洁发版清单。

严格遵循 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)。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/