npm-update

更新套件

選擇 CLI 版本

概要

npm update [<pkg>...]

aliases: up, upgrade, udpate

說明

此指令會將所有列出的套件更新至最新版本 (由 tag 設定指定)，並遵守套件及其依賴項 (如果它們也需要相同的套件) 的 semver 限制。

它還會安裝遺失的套件。

如果指定 -g 旗標，此指令會更新已安裝的全球套件。

如果未指定套件名稱，則會更新指定位置 (全域或本機) 中的所有套件。

請注意，預設情況下 npm update 不會更新專案 package.json 中直接依賴項的 semver 值。如果您也想要更新 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"
  ]
}

Caret 相依性

如果 app 的 package.json 包含

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

則 npm update 會安裝 dep1@1.2.2，因為 1.2.2 是 latest，而且 1.2.2 符合 ^1.1.1。

Tilde 相依性

然而，如果 app 的 package.json 包含

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

在這種情況下，執行 npm update 將安裝 dep1@1.1.2。即使 latest 標籤指向 1.2.2，這個版本也不滿足 ~1.1.1，這等於 >=1.1.1 <1.2.0。因此，將使用滿足 ~1.1.1 的最高排序版本，即 1.1.2。

低於 1.0.0 的 Caret 相依性

假設 app 對低於 1.0.0 的版本有插入符號依賴項，例如

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

npm update 將安裝 dep1@0.2.0。

如果依賴項在 ^0.4.0

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

然後 npm update 將安裝 dep1@0.4.1，因為那是滿足 ^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 將安裝 dep1@1.1.2，因為那是 dep2 允許的最高版本。npm 優先在您的樹中有一個 dep1 的單一版本，而不是兩個，當該單一版本可以滿足您的樹中多個依賴項的 semver 需求時。在這種情況下，如果您真的需要您的套件使用較新的版本，您需要使用 npm install。

更新全球安裝的套件

npm update -g 將對每個已過時的全局安裝套件套用 update 動作，也就是說，版本與 wanted 不同。

注意：全球安裝的套件會被視為已安裝，並指定為插入符號 semver 範圍。因此，如果您需要更新到 最新，您可能需要執行 npm install -g [<pkg>...]

注意：如果套件已升級到比 最新 更新的版本，它將會被降級。

設定

`儲存`

預設：true，除非使用 npm update，預設為 false
類型：布林值

將安裝的套件儲存到 package.json 檔案中，作為相依性。

與 npm rm 命令一起使用時，會從 package.json 中移除相依性。

如果設定為 false，也會防止寫入 package-lock.json。

`全域`

預設：false
類型：布林值

在「全域」模式中操作，以便將套件安裝到 prefix 資料夾，而不是目前的作業目錄。請參閱資料夾，以進一步了解行為差異。

套件會安裝到 {prefix}/lib/node_modules 資料夾，而不是目前的作業目錄。
bin 檔案會連結到 {prefix}/bin
man 頁面會連結到 {prefix}/share/man

`安裝策略`

預設：「hoisted」
類型：「hoisted」、「nested」、「shallow」或「linked」

設定在 node_modules 中安裝套件的策略。hoisted（預設）：在頂層安裝非重複的，並在目錄結構中視需要重複安裝。nested：（以前稱為 --legacy-bundling）就地安裝，不提升。shallow（以前稱為 --global-style）只在頂層安裝直接相依性。linked：（實驗性）安裝在 node_modules/.store 中，就地連結，未提升。