版本说明
语义版本规范
package.json 中的版本必须要遵循语义化版本规范(Semantic Versioning)。
plaintext
MAJOR.MINOR.PATCH详细说明:
MAJOR(主版本号)
表示有破坏性更改的版本更新,无法向后兼容。
例如:1.0.0 升级到 2.0.0
MINOR(次版本号)
表示新增了功能,但仍向后兼容。
例如:1.1.0 升级到 1.2.0
PATCH(修订号)
表示修复了问题,或者进行了向后兼容的修复或小更新。
例如:从 1.0.1 升级到 1.0.2
注意:一般来说,项目的版本从 1.0.0 开始
主版本发版出现不兼容升级的情况下,一般标注需要标注Breaking Changes
版本前缀
^
插入符号: 匹配 "兼容版本",即允许更新到 MAJOR 不变的最新版本。
sh
^1.2.3: >=1.2.3 <2.0.0~
匹配 "小版本号范围",即允许更新到 PATCH 的最新版本。
sh
~1.2.3: >=1.2.3 <1.3.0无符号
指定精确版本,只有该版本符合要求。
* 或 x
表示任何版本均可。
sh
1.2.x: >=1.2.0 <1.3.0
*: 任意版本比较运算符
明确限制版本范围的操作符
sh
>=1.2.3: 表示安装版本 1.2.3 或更高版本
<2.0.0: 表示安装 2.0.0 之前的版本预发布版本
预发布版本用于标识尚未正式发布的版本,格式为:
plaintext
MAJOR.MINOR.PATCH-<标识>标识一般包括(alpha、beta、rc):
- 1.0.0-alpha
- 1.0.0-beta.2
- 1.0.0-rc.1(Release Candidate)