Skip to content

版本说明

语义版本规范

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)

基于 MIT 许可发布