semver.md

Semver 备忘清单

这个 semver 语义化版本快速参考备忘清单。

语义化版本标准

介绍

Semver 是一种语义版本控制规范。

• 语义版本控制规范文档 (semver.org)
• npm 的语义版本器 (npmjs.com)

Semver

-	-
主版本号(MAJOR)	当你做了不兼容的 API 修改
次版本号(MINOR)	当你做了向下兼容的功能性新增
修订号(PATCH)	当你做了向下兼容的问题修正

简单范围

  1.2.3
 =1.2.3
 >1.2.3
 <1.2.3
>=1.2.3

请注意，后缀版本（1.2.3-rc1）不匹配。

范围

范围	描述	Notes
~1.2.3	是 >=1.2.3 <1.3.0
^1.2.3	是 >=1.2.3 <2.0.0
^0.2.3	是 >=0.2.3 <0.3.0	(0.x.x 是特殊的)
^0.0.1	是 =0.0.1	(0.0.x 是特殊的)
^1.2	是 >=1.2.0 <2.0.0	(像 ^1.2.0)
~1.2	是 >=1.2.0 <1.3.0	(像 ~1.2.0)
^1	是 >=1.0.0 <2.0.0
~1	相同的
1.x	相同的
1.*	相同的
1	相同的
*	任何版本
x	相同的

连字符范围

范围	描述
1.2.3 - 2.3.4	是 >=1.2.3 <=2.3.4

部分向右

范围	描述
1.2.3 - 2.3	是 >=1.2.3 <2.4.0
1.2.3 - 2	是 >=1.2.3 <3.0.0

部分向左

范围	描述
1.2 - 2.3.0	是 1.2.0 - 2.3.0

当右侧为部分（例如，2.3）时，假定缺失的部分为x（例如， 2.3.x）。

如果左边是部分的（例如，1.2），则假定缺少的部分为0（例如， 1.2.0）。

组合范围

范围	描述
>=0.14 <16	和 (空格分隔)
0.14.x || 15.x.x	或 (双竖线分隔)

预发布

1.2.3-prerelease+build

解释

范围	描述
^	意思是“兼容”
~	意思是“相当接近”
0.x.x	用于“初始开发”
1.x.x	表示定义了公共 API

另见

• 语义化版本号验证正则表达式，支持按编号提取的语言
• 语义化版本号验证正则表达式，支持按组名称提取的语言