语义化版本号比较

比较两个版本号的大小并说明差在哪一位,正确处理 alpha、beta、rc 等预发布版本;按 npm 的规则解析 ^、~、x、范围和 ||,检查哪些版本满足;还能批量排序版本号,算出下一个版本号。

    版本号规则

    • 主版本.次版本.修订号:不兼容的改动升主版本(MAJOR),向下兼容的新功能升次版本(MINOR),向下兼容的问题修复升修订号(PATCH)。升高位时低位归零,例如 1.4.2 加新功能变为 1.5.0。
    • 每一位按数字比较:1.10.0 比 1.9.0 大,不能按字符串比较。
    • 预发布版本更小:1.0.0-rc.1 小于 1.0.0。预发布标识按点分段比较,纯数字段按数值比较,字母段按 ASCII 顺序,数字段小于字母段,段数多的更大:1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0-rc.1 < 1.0.0。
    • 构建信息不参与比较:加号后面的内容(如 +build.7、+20261023)只是附加信息,1.0.0+a 和 1.0.0+b 优先级相同。
    • 0.x 版本:主版本为 0 表示还在开发阶段,任何改动都可能不兼容,所以 npm 对 ^0.2.3 只允许升级到 0.2.x。
    写法含义允许的版本
    ^1.2.3兼容版本(npm install 的默认写法)>=1.2.3 <2.0.0
    ^0.2.30.x 时只允许修订号升级>=0.2.3 <0.3.0
    ~1.2.3只允许修订号升级>=1.2.3 <1.3.0
    1.2.x、1.21.2 系列的任意版本>=1.2.0 <1.3.0
    1.2.3 - 2.3闭区间,右侧不完整时按通配>=1.2.3 <2.4.0
    >=1.0 <2 || 3.x空格表示“并且”,|| 表示“或者”两段任一满足即可
    *、latest任意版本(不推荐)所有正式版本

    Composer(PHP)和 Cargo(Rust)的 ^ ~ 规则与 npm 基本相同;Python 的 ~=1.4.2 相当于 >=1.4.2 <1.5,与 npm 的 ~ 接近。编辑 package.json 可以用 package.json 生成器,各包管理器的命令见 npm、pnpm、yarn、bun 命令对照表。

    语义化版本号比较常见问题

    语义化版本号比较怎么使用?

    在“比较”中输入两个版本号,查看大小关系和原因;在“范围匹配”中填写 package.json 中的版本范围和要检查的版本列表;在“排序”中粘贴一组版本号;在“下一个版本”中输入当前版本,查看各种升级方式的结果和 npm 命令。

    1.10.0 和 1.9.0 哪个大?

    1.10.0 更大,版本号每一位按数字比较,不是按字符串。

    ^1.2.3 和 ~1.2.3 有什么区别?

    ^1.2.3 允许升级到 2.0.0 以下的任何版本,~1.2.3 只允许升级到 1.3.0 以下。

    1.0.0-rc.1 和 1.0.0 哪个大?

    1.0.0 更大,带预发布标识的版本小于对应的正式版本。

    为什么 ^0.2.3 不能升级到 0.3.0?

    主版本为 0 时任何次版本变化都可能不兼容,npm 只允许升级修订号。

    语义化版本号比较的结果应怎样理解?

    按 SemVer 2.0.0 和 npm(node-semver)的规则处理;非标准的版本号(如 1.2、10.0.19045.1)在比较中按通用规则逐段比较,在范围匹配和排序中会被忽略。

    输入内容会保存或发给外部服务吗?

    所有计算在浏览器本地完成,不会上传。

    没有结果或操作失败时先检查什么?

    预发布版本没有匹配时,是因为 npm 默认只在范围中写了同一版本号的预发布时才匹配,可以勾选“预发布版本也参与匹配”。

    相关工具

    npm、pnpm、yarn、bun 命令对照表 · package.json 生成器 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具