package.json 中依赖外部组件时常用的版本符号含义

2020-11-30  本文已影响0人  沐风雨木

突然想起之前开发 rn 时,给同事配置 rn 环境,并运行代码,此时代码无论如何也编译不起来,很是莫名其妙,究其原因是 package.json 中依赖外部组件版本号其前面的符号导致的,导致这名同事依赖的三方库,与我本地环境中的不一样。而此时那组件版本也有其兼容问题,导致的。特转此文章,记录一下其中符号意义。

package.json 中会有 dependencies 定义了项目依赖的外部组件,这些外部组件的依赖都是带有版本符号以表示被依赖组件的版本范围,如:

{ "dependencies" :
  { "foo" : "1.0.0 - 2.9999.9999"
  , "bar" : ">=1.0.2 <2.1.2"
  , "baz" : ">1.0.2 <=2.3.4"
  , "boo" : "2.0.1"
  , "qux" : "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0"
  , "asd" : "http://asdf.com/asdf.tar.gz"
  , "til" : "~1.2"
  , "elf" : "~1.2.3"
  , "two" : "2.x"
  , "thr" : "3.3.x"
  , "lat" : "latest"
  , "dyl" : "file:../dyl"
  }
}

项目中往往会依赖很多的外部组件,而这些组件都是开源,使用开源的组件时首先要注意的就是它的版本,版本号的差异会造成功能上的很大偏差,搞明白 npm 中版本符号的含义就是使用组件的基础,npm 中的版本符号就是限定版本范围的符号。

版本的格式
major.minor.patch
主版本号.次版本号.修补版本号
版本符号 说明 示例
version 必须匹配某个版本 如:1.1.2,表示必须依赖1.1.2版
>version 必须大于某个版本 如:>1.1.2,表示必须大于1.1.2版
>=version 可大于或等于某个版本 如:>=1.1.2,表示可以等于1.1.2,
也可以大于1.1.2版本
<version 必须小于某个版本 如:<1.1.2,表示必须小于1.1.2版本
<=version 可以小于或等于某个版本 如:<=1.1.2,表示可以等于1.1.2,也可以小于1.1.2版本
~version 大概匹配某个版本 如果minor版本号指定了,那么minor版本号不变,
而patch版本号任意。如果minor和patch版本号未指定,
那么minor和patch版本号任意,
如:~1.1.2,表示>=1.1.2 <1.2.0,
可以是1.1.2,1.1.3,1.1.4,.....,1.1.n
如:~1.1,表示>=1.1.0 <1.2.0,可以是同上
如:~1,表示>=1.0.0 <2.0.0,
可以是1.0.0,1.0.1,1.0.2,.....,1.0.n,1.1.n,1.2.n,.....,1.n.n
^version 兼容某个版本 版本号中最左边的非0数字的右侧可以任意。
如果缺少某个版本号,则这个版本号的位置可以任意,
如:^1.1.2 ,表示>=1.1.2 <2.0.0,
可以是1.1.2,1.1.3,.....,1.1.n,1.2.n,.....,1.n.n
如:^0.2.3 ,表示>=0.2.3 <0.3.0,
可以是0.2.3,0.2.4,.....,0.2.n
如:^0.0,表示 >=0.0.0 <0.1.0,
可以是0.0.0,0.0.1,.....,0.0.n
x-range x的位置表示任意版本 如:1.2.x,表示可以1.2.0,1.2.1,.....,1.2.n
*-range 任意版本,""也表示任意版本 如:*,表示>=0.0.0的任意版本
version1 - version2 大于等于version1,小于等于version2 如:1.1.2 - 1.3.1,
表示包括1.1.2和1.3.1以及他们件的任意版本

最后,还有

range1 || range2
满足range1或者满足range2,可以多个范围
如:<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0,表示满足这3个范围的版本都可以
最后,转自:package.json for npm中依赖外部组件时常用的版本符号含义
上一篇下一篇

猜你喜欢

热点阅读