语义化版本（SemVer）的范围

最新推荐文章于 2025-07-21 22:29:26 发布

赵天明

最新推荐文章于 2025-07-21 22:29:26 发布

阅读量1k

点赞数

本文详细介绍了语义化版本控制的格式与范围定义，包括如何理解版本号的构成及其变化规则，以及如何灵活运用版本范围的多种表达形式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转自 http://www.u396.com/semver-range.html

在使用 Node.js 和 Bower 的时候，其中的 package.json 和 bower.json 都会有 dependencies、devDependencies 项，对于此前端开发的童鞋应该会比较熟悉。这里面是运行时和开发时依赖库，其中依赖库对应的版本号有很多种写法，诸如：”~1.0.2“, “^1.0“, “>=1.0.2“等，其实可以猜测这种写法代表了某种范围，至于具体含义本文给大家做详细解释。

语义化版本格式

我们首先简单了解一下语义化版本版本号，标准的版本格式为：X.Y.Z，其中：

X：主版本号，当我们做了不兼容或者颠覆性的更新，修改此版本号。
Y：此版本号，当我们做了向下兼容的功能性修改，修改此版本号。
Z：修订号，当我们做了向下兼容的问题修正，修改此版本号。
其中X、Y和Z必须为非负整数，禁止数字前补零，每个数值都是递增的。

标题语义化版本范围

版本范围是一组满足指定范围的比较器，一个比较器是由操作符和版本号组成，下面是最原始的操作符：

< 小于；
<= 小于等于；
> 大于；
>= 大于等于；
= 等于；如果没有指定操作符，则默认为等于。
一个范围可由一个或者多个比较器组成，如果有多个，则由双竖线（||）连接。对于包含多个比较器，只要满足其一即可。比如：
范围 >=1.2.7 <1.3.0 ，版本号 1.2.7, 1.2.8, 1.2.99 满足条件，而 1.2.6, 1.3.0, 1.1.0 确不满足。
范围 1.2.7 || >=1.2.9 <2.0.0 ，版本号 1.2.7, 1.2.9, 1.4.6 满足，而 1.2.8 或者 2.0.0不满足。

标题关于测试版

Alpha、Beta、Gamma与α、β、λ谐音，是希腊字母前三个字母，用来表示软件开发过程中测试的三个阶段：

Alpha：内测版，内部交流或者专业测试人员测试用；
Beta：公测版，专业爱好者大规模测试用，存在一些缺陷，该版本也不适合一般用户安装；
Gamma：比较成熟的测试版，与即将发行的正式版相差无几；
RC：是 Release Candidate 的缩写，意思是发布倒计时，候选版本，处于Gamma阶段，该版本已经完成全部功能并清除大部分的BUG。到了这个阶段只会除BUG，不会对软件做任何大的更改。从Alpha到Beta再到Gamma是改进的先后关系，但RC1、RC2往往是取舍关系。
Stable：稳定版。在开源软件中，都有stable版，这个就是开源软件的稳定发行版。

范围>1.2.3-alpha.3，版本1.2.3-alpha.7符合条件，而3.4.5-alpha.9却不满足条件。虽然 3.4.5-alpha.9 实际上大于 1.2.3-alpha.3，但是根据 SemVer 的排序规则，这个版本范围只是接受 1.2.3 的测试版，而不接受其他版本的测试版。当然 3.4.5 满足条件，因为它不是测试版，并且大于 1.2.3-alpha.7。

这么做是有两个目的，首先测试版会经常更新并且可能包含不适合公开的重大改动，因此被排除在范围之外；再者，虽然用户明确此次使用有风险的测试版本，然而下一版本的测试版被包含进来仍然是不合适的。

标题版本范围高级用法

在版本范围的高级用法中，与原始的比较器不同，组合不仅仅限于空格和双竖线，它有以下几种方式。

连接符（-）范围 `X.Y.Z - A.B.C`

下面表示的闭包集合

1.2.3 - 2.3.4 := >=1.2.3 <=2.3.4
如果范围中的第一个版本号只有一部分，剩下的部分以零填充。
1.2 - 2.3.4 := >=1.2.0 <=2.3.4
如果范围中的第二个版本号只有一部分，代表范围中包含了这个版本。
1.2.3 - 2.3 := >=1.2.3 <2.4.0
1.2.3 - 2 := >=1.2.3 <3.0.0

X范围 `1.2.x 1.X 1.2.* *`

X, x或者 * 可以用在主版本号、此版本号以及修订版本号的任何一个上面。

-* := >=0.0.0 (任何版本都满足)

1.x := >=1.0.0 <2.0.0 (只要满足主版本号即可)
1.2.x := >=1.2.0 <1.3.0 (需要满足主版本和此版本号)
部分版本号的含义与X范围表示含义一样，所以X或者*都是可以省略的。

-"" (空字符串) := * := >=0.0.0

1 := 1.x.x := >=1.0.0 <2.0.0
1.2 := 1.2.x := >=1.2.0 <1.3.0

波浪线（~）范围 ~1.2.3 ~1.2 ~1

~1.2.3 := >=1.2.3 <1.(2+1).0 := >=1.2.3 <1.3.0
~1.2 := >=1.2.0 <1.(2+1).0 := >=1.2.0 <1.3.0 (类似于 1.2.x)
~1 := >=1.0.0 <(1+1).0.0 := >=1.0.0 <2.0.0 (类似于 1.x)
~0.2.3 := >=0.2.3 <0.(2+1).0 := >=0.2.3 <0.3.0
~0.2 := >=0.2.0 <0.(2+1).0 := >=0.2.0 <0.3.0 (类似于 0.2.x)
~0 := >=0.0.0 <(0+1).0.0 := >=0.0.0 <1.0.0 (类似于 0.x)
~1.2.3-beta.2 := >=1.2.3-beta.2 <1.3.0 注意版本为1.2.3且大于等于beta.2的测试版本在范围内，因此 1.2.3-beta.4 满足条件，而1.2.4-beta.2不满足条件。