npm-update

更新包

选择 CLI 版本

概要

npm update [<pkg>...]

aliases: up, upgrade, udpate

描述

此命令将根据您的包及其依赖项的语义版本控制约束（如果它们也需要同一个包），将所有列出的包更新到最新版本（由 tag 配置指定）。

它也会安装缺少的包。

如果指定了 -g 标志，此命令将更新全局安装的包。

如果没有指定包名，则将更新指定位置（全局或本地）的所有包。

请注意，默认情况下 npm update 不会更新项目 package.json 中直接依赖项的语义版本控制值。如果您还想更新 package.json 中的值，您可以运行：npm update --save（或将 save=true 选项添加到配置文件中，使其成为默认行为）。

示例

对于以下示例，假设当前包为 app，并且它依赖于依赖项 dep1 (dep2，等等)。 dep1 的发布版本为

{
  "dist-tags": { "latest": "1.2.2" },
  "versions": [
    "1.2.2",
    "1.2.1",
    "1.2.0",
    "1.1.2",
    "1.1.1",
    "1.0.0",
    "0.4.1",
    "0.4.0",
    "0.2.0"
  ]
}

脱字符依赖项

如果 app 的 package.json 包含

"dependencies": {
  "dep1": "^1.1.1"
}

那么 npm update 将安装 [email protected]，因为 1.2.2 是 latest，并且 1.2.2 满足 ^1.1.1。

波浪号依赖项

但是，如果 app 的 package.json 包含

"dependencies": {
  "dep1": "~1.1.1"
}

在这种情况下，运行 npm update 将安装 [email protected]。即使 latest 标签指向 1.2.2，此版本也不满足 ~1.1.1，它等效于 >=1.1.1 <1.2.0。因此，使用满足 ~1.1.1 的最高排序版本，即 1.1.2。

1.0.0 以下的脱字符依赖项

假设 app 对 1.0.0 以下的版本具有脱字符依赖项，例如

"dependencies": {
  "dep1": "^0.2.0"
}

npm update 将安装 [email protected]。

如果依赖项是 ^0.4.0

"dependencies": {
  "dep1": "^0.4.0"
}

那么 npm update 将安装 [email protected]，因为这是满足 ^0.4.0 (>= 0.4.0 <0.5.0) 的最高排序版本。

子依赖项

假设您的应用程序现在还依赖于 dep2

{
  "name": "my-app",
  "dependencies": {
    "dep1": "^1.0.0",
    "dep2": "1.0.0"
  }
}

并且 dep2 本身依赖于 dep1 的此有限范围

{
  "name": "dep2",
  "dependencies": {
    "dep1": "~1.1.1"
  }
}

那么 npm update 将安装 [email protected]，因为这是 dep2 允许的最高版本。npm 将优先在您的树中使用单个版本的 dep1 而不是两个版本，只要单个版本能够满足您树中多个依赖项的语义版本控制要求。在这种情况下，如果您确实需要您的包使用更新的版本，则需要使用 npm install。

更新全局安装的包

npm update -g 将对每个全局安装的包应用 update 操作，这些包是 outdated 的——也就是说，其版本与 wanted 不同。

注意：全局安装的包被视为使用脱字符语义版本控制范围安装。因此，如果您需要更新到 latest，则可能需要运行 npm install -g [<pkg>...]

注意：如果包已升级到比 latest 更新的版本，它将被 *降级*。

配置

`save`

默认：true，除非使用 npm update，在这种情况下，它默认为 false
类型：布尔值

将安装的包保存到 package.json 文件中作为依赖项。

与 npm rm 命令一起使用时，从 package.json 中删除依赖项。

如果设置为 false，也将阻止写入 package-lock.json。

`global`

默认值：false
类型：布尔值

在“全局”模式下运行，因此包被安装到 prefix 文件夹中，而不是当前工作目录。有关行为差异的更多信息，请参阅文件夹。

包被安装到 {prefix}/lib/node_modules 文件夹中，而不是当前工作目录。
bin 文件链接到 {prefix}/bin
手册页链接到 {prefix}/share/man

`install-strategy`

默认值： "hoisted"
类型： "hoisted"、"nested"、"shallow" 或 "linked"

设置在 node_modules 中安装包的策略。hoisted（默认）：在顶层安装非重复项，并在目录结构中根据需要重复安装。nested：（以前为 --legacy-bundling）就地安装，不提升。shallow（以前为 --global-style）只在顶层安装直接依赖项。linked：（实验性）安装在 node_modules/.store 中，就地链接，不提升。