跳至主要內容
版本：7.x

安裝

使用獨立指令碼安裝​

即使沒有安裝 Node.js，您也可以使用下列命令來安裝 pnpm。

Windows​

使用 PowerShell：

iwr https://get.pnpm.io/install.ps1 -useb | iex

POSIX 系統​

curl -fsSL https://get.pnpm.io/install.sh | sh -

如果您的系統中沒有安裝 curl，您也可以使用 wget：

wget -qO- https://get.pnpm.io/install.sh | sh -

Alpine Linux​

# bash
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.bashrc" SHELL="$(which bash)" bash -
# sh
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.shrc" SHELL="$(which sh)" sh -
# dash
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.dashrc" SHELL="$(which dash)" dash -

必要條件​

若不想使用指令碼來安裝 pnpm，您的系統需有 Node.js（需高於 v14 版）。

安裝特定版本​

在執行安裝指令碼之前，您可以設定 shell 變數 PNPM_VERSION 以安裝特定版本的 pnpm：

curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=<version> sh -
提示

接下來您可以使用 pnpm env 命令來安裝 Node.js了。

使用 Corepack 安裝​

從 v16.13 開始，Node.js 發布了 Corepack 用以管理套件管理器。 這是一項實驗性功能，所以您需要先輸入以下命令來啟用：

corepack enable

若您先前使用 Homebrew 安裝 Node.js，您需要單獨安裝 corepack：

brew install corepack

此指令將自動在您的系統上安裝 pnpm， 然而它安裝的可能不是最新版。 然而它安裝的可能不是最新版。 如要升級，請檢查 最新的 pnpm 版本 後並執行：

corepack prepare pnpm@<version> --activate

如您使用的 Node.js 是 16.17 或更新的版本，只需指定版本標籤即可安裝 最新的 版本。

corepack prepare pnpm@latest --activate

使用 npm​

npm install -g pnpm

使用 Homebrew​

如果您已安裝 Homebrew 套件管理器，可以透過以下命令安裝 pnpm：

brew install pnpm

使用 Scoop​

如果您已安裝 Scoop，可以透過以下命令安裝 pnpm：

scoop install nodejs-lts pnpm
提示

您想在 CI 伺服器上使用 pnpm 嗎？ 請參閱 持續整合 (CI)

相容性​

以下是過去 pnpm 版本與 Node.js 各個版本的相容性表格：

Node.jspnpm 4pnpm 5pnpm 6pnpm 7
Node.js 10✔️✔️❌❌
Node.js 12✔️✔️✔️❌
Node.js 14✔️✔️✔️✔️
Node.js 16?️?️✔️✔️
Node.js 18?️?️✔️✔️

疑難排解​

如果 pnpm 損毀且無法透過重新安裝來修復，您可能得手動將它移出 PATH。

假設您在執行 pnpm install 命令時發生了遭遇此錯誤訊息：

C:\src>pnpm install
internal/modules/cjs/loader.js:883
  throw err;
  ^



Error: Cannot find module 'C:\Users\Bence\AppData\Roaming\npm\pnpm-global\4\node_modules\pnpm\bin\pnpm.js'
←[90m    at Function.Module._resolveFilename (internal/modules/cjs/loader.js:880:15)←[39m
←[90m    at Function.Module._load (internal/modules/cjs/loader.js:725:27)←[39m
←[90m    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)←[39m
←[90m    at internal/main/run_main_module.js:17:47←[39m {
  code: ←[32m'MODULE_NOT_FOUND'←[39m,
  requireStack: []
}

首先，請嘗試執行 which npm 來尋找 pnpm 存放的位置。 如果您使用的是 Windows 系統，在 Git Bash 中執行前述命令， 您將取得 pnpm 命令的位置，例如: 您將取得 pnpm 命令的位置，例如:

$ which pnpm
/c/Program Files/nodejs/pnpm

現在已經知道 pnpm CLI 存放的位置，請打開該目錄並移除所有與 pnpm 有關的檔案（如 pnpm.cmd、pnpx.cmd、pnpm 等等）。 完成後再重新安裝 pnpm，應該就恢復正常了。

使用較短的別名​

pnpm 可能很難輸入，因此，您可以使用較短的別名 pn 來取代它。

在 POSIX 系統中加入永久別名​

將下面這行命令加入 .bashrc、.zshrc 或 config.fish 就完成了：

alias pn=pnpm

在 Powershell 中加入永久別名 (Windows)：​

以系統管理員權限開啟 Powershell 視窗並執行此命令：

notepad $profile.AllUsersAllHosts

接著會打開 profile.ps1 檔案，在裡頭加上：

set-alias -name pn -value pnpm

存檔後關閉視窗。 您可能需要關閉其他還開啟的 Powershell 視窗，才能讓此別名設定生效。

解除安裝 pnpm​

如果您需要從系統及其寫入磁碟中的任何檔案中移除 pnpm CLI，請參閱〈解除安裝 pnpm〉。