我们可以通过package.json来限定我们想要引用的包的版本范围,这里描述下相关的语法,便于在以后查看package.json的时候不会有疑惑:
版本表示
版本只有三段,分别代表: major.minor.patch
- major:发生不兼容的API改变时变更这个版本号段
- minor:以向后兼容的方式增加了一些功能时变更这个版本号段
- patch:修复了一些bug但仍保持向后兼容时变更这个版本号段
Prerelease Tag
版本还可以有个预发布标记(alpha、beta、rc),并以短横隔开,预发布标记也可以带上自己的版本号段,形如: 1.2.3-beta.5
一旦有预发布标记,那么版本范围的语法表示就和普通的三段式版本范围有所不同,其范围的限定都是在前三段版本major.minor.patch一致的基础上,并且是相同的预发布标记情形来对预发布版本号段进行范围限定,例如:1.2.3-beta.6是满足比1.2.3-beta.5要大的版本,但1.2.4或1.2.3-rc.2这样的都不满足
版本范围的语法表示
- x、X、*这三个用来表示任意数值(可以用一个开闭区间来表示)
* 表示 [0.0.0, ) 即任意版本
1.x 表示 [1.0.0, 2.0.0) 的版本
1.2.X 表示 [1.2.0, 1.3.0) 的版本
- 用 X.Y.Z - A.B.C 这样的方式来表达版本范围,缺失的版本号段用x补上
1.2.3 - 2.3.4 即 [1.2.3, 2.3.4],两个闭区间
1.2 - 2.3.4 即 1.2.x - 2.3.4 即 [1.2.0, 2.3.4],也是两个闭区间
1.2.3 - 2.3 即 1.2.3 - 2.3.x 即 [1.2.3, 2.4.0),闭开区间
1.2.3 - 2 即 1.2.3 - 2.x.x 即 [1.2.3, 3.0.0),闭开区间
- ~X.Y.Z语法
允许最右边明确的版本号段往高发生改变,保持其余版本号段不变;如果只有单一的明确版本号,那么需保持这个号段不变,其他非明确的可以往高发生变化
~1.2.3 即 [1.2.3, 1.3.0)
~1.2 即 [1.2.0, 1.3.0) 和1.2.x一样
~1 即 [1.0.0, 2.0.0) 和1.x一样
~0.2.3 即 [0.2.3, 0.3.0)
~0.2 即 [0.2.0, 0.3.0) 和 0.2.x一样
~0 即 [0.0.0, 1.0.0) 和0.x一样
~1.2.3-beta.2 即 [1.2.3-beta.2, 1.3.0),注意这种带预发布标记要求major.minor.patch三个版本号一样
- ^X.Y.Z语法
只要最左边非0的确定版本号段不发生变化,其他号段可以往高发生变化,如果确定的版本号段都是0,那么最左边的0保持不变,其他版本号段往高发生变化
^1.2.3 即 [1.2.3, 2.0.0)
^0.2.3 即 [0.2.3, 0.3.0)
^0.0.3 即 [0.0.3, 0.0.4)
^0.0.3-beta 即 [0.0.3-beta, 0.0.4),注意需同时满足预发布标记版本的要求
^1.2.x 即 [1.2.0, 2.0.0)
^0.0 即 [0.0.0, 0.1.0) 和 ^0.0.x一样
^1.x 即 [1.0.0, 2.0.0)
^0.x 即 [0.0.0, 1.0.0)
一般正式版本为1.0.0,那么在版本低于1.0.0的0.x开发阶段,0.2到0.3的变化很有可能是会发生巨大变化而产生不兼容的,所以^0.2这样的语法就可以适应这种场景