Semver 检查器
检查、比较和排序语义化版本,并使用 npm 风格的范围进行测试,例如 ^1.2.0、~2.4、>=1.0.0 <2.0.0、1.x 或 1.2.3 - 2.3.4。检查器遵循语义化版本规范 2.0.0 中有关预发布版本和构建元数据的规则,以及与 npm 的 semver 包相同的范围规则;它会显示范围展开后的内容,并找出满足条件的最高版本。
常见问题
此检查器能做什么?
它会解析你输入的每个版本,说明其是否为有效的语义化版本,对有效版本进行排序并指出最高版本;输入范围后,还会告诉你哪些版本满足该范围,以及其中最高的版本。恰好输入两个版本时,它还会说明哪个版本更高。
^1.2.3 表示什么?
插入符号允许更新,但不会改变最左侧的非零数字。^1.2.3 表示 >=1.2.3 <2.0.0,^0.2.3 表示 >=0.2.3 <0.3.0,而 ^0.0.3 仅表示 0.0.3。安装软件包时,它是 npm 的默认设置。
~1.2.3 表示什么?
波浪号允许更新补丁版本:~1.2.3 表示 >=1.2.3 <1.3.0。只指定主版本时,~1 表示 >=1.0.0 <2.0.0。如果你需要错误修复,但不需要新的次要版本功能,可以使用它。
支持哪些范围语法?
比较运算符(<、<=、>、>=、=)、插入符号和波浪号范围、X 范围(例如 1.x、1.2.* 和 *)、部分版本(例如 1.2)、连字符范围(例如 1.2.3 - 2.3.4)、以空格分隔且必须全部匹配的多个比较条件,以及以 || 分隔的多个备选范围。
如何比较预发布版本?
预发布版本(例如 1.0.0-beta.2)低于正式发布版本 1.0.0。预发布标识符会逐个比较:数字按数值比较,文本按字母顺序比较,且数字始终低于文本,因此 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0。
为什么 2.0.0-beta 不满足 ^1.2.0?
根据 npm,只有当范围中的某个比较条件指定了相同主版本、次版本和补丁版本的预发布版本时,预发布版本才满足该范围,这样范围就不会意外包含不稳定版本。启用“包含预发布版本”后,它们便可像普通版本一样匹配;与 npm 一样,此时部分版本范围和连字符范围的下限也会包含预发布版本。
什么是范围展开?
检查器会将范围显示为它所代表的普通比较条件,例如 ^1.2.3 = >=1.2.3 <2.0.0-0。-0 后缀表示该边界也排除 2.0.0 的预发布版本,这与 npm 的 semver 包写出的形式完全一致。
会比较构建元数据吗?
不会。语义化版本规范在比较时会忽略构建元数据,也就是加号之后的部分,因此 1.0.0+build.1 和 1.0.0+build.2 相等。检查器会显示元数据,但不会将其用于排序或范围匹配。
接受以 v 开头的版本吗?
接受。开头的 v 会被忽略,因此 v1.2.3 会被解析为 1.2.3,npm 也是如此。少于三个数字的版本(例如 1.2)不是有效版本,但可以用于范围;在范围中,1.2 表示任意 1.2.x 版本。
最多可以检查多少个版本?
每次请求最多检查 200 个版本,每行一个;范围最多可包含 1,000 个字符。