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

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个范围的版本都可以

 

参考：

https://docs.npmjs.com/files/package.json

https://docs.npmjs.com/misc/semver

https://github.com/npm/node-semver

http://ju.outofmemory.cn/entry/130809