NPM版本号规则以及更新策略

发表于 分类于

初次使用NodeJS的时候，被package.json中的版本规则搞晕，现在记录一下。

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标识符

x的位置表示任意版本

如：1.2.x，表示可以1.2.0，1.2.1，…..，1.2.n

*标识符

任意版本，””也表示任意版本

如：*，表示>=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个范围的版本都可以

install和update区别

The difference between npm install and npm update handling of package versions specified in package.json:

1
2
3
4
5
6
7
8
9
10
11
12
{
  "name":          "my-project",
  "version":       "1.0",                             // install   update
  "dependencies":  {                                  // ------------------
    "already-installed-versionless-module":  "*",     // ignores   "1.0" -> "1.1"
    "already-installed-semver-module":       "^1.4.3" // ignores   "1.4.3" -> "1.5.2"
    "already-installed-versioned-module":    "3.4.1"  // ignores   ignores
    "not-yet-installed-versionless-module":  "*",     // installs  installs
    "not-yet-installed-semver-module":       "^4.2.1" // installs  installs
    "not-yet-installed-versioned-module":    "2.7.8"  // installs  installs
  }
}

总结: 两者最大的区别是在对待已经安装过的模糊版本时候

  • npm install会忽略模糊版本
  • npm update会更新模糊版本至最新

另外:install and update 处理 devDependencies 方式也不同

  • npm install 会安装/更新devDependencies，除非你指定 –production标志
  • npm update 会忽略 devDependencies，除非你指定 –dev 标志

来自 https://stackoverflow.com/questions/12478679/npm-install-vs-update-whats-the-difference