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