版本：下一個

安裝

必要條件

If you don't use the standalone script or @pnpm/exe to install pnpm, then you need to have Node.js (at least v18.12) to be installed on your system.

使用指令稿來安裝

即使沒有安裝 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 -

提示

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

在 Docker 容器中

# 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 -

安裝特定版本

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

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

使用 Corepack 來安裝

自 16.13 版起，Node.js 推出了 Corepack——管理套件管理器的工具。因為這是試驗性功能，需執行此命令以啟用 Corepack：

資訊

如果您是以 pnpm env 安裝 Node.js，則不會順帶安裝 Corepack。如須使用 Corepack，則需另外安裝。詳情請參閱 #4029。

corepack enable pnpm

若您先前使用 Homebrew 安裝 Node.js，則需另外安裝 corepack：

brew install corepack

它會在您的電腦上自動安裝 pnpm，

您可以使用此命令來釘選專案中使用的 pnpm 版本

corepack use pnpm@latest

這會在專案的 package.json 中加入 "packageManager" 欄位，指示 Corepack 在進入專案時選用特定版本。此功能對於需強調可重現性時很有用，因為所有使用 Corepack 的開發者都使用與您相同的版本。當新版 pnpm 推出時，您可以再次執行上述命令。

使用 npm 來安裝

我們提供了兩個 pnpm CLI 包裝， pnpm 和 @pnpm/exe。

pnpm 為一般版本的 pnpm，需要 Node.js 才能執行。
@pnpm/exe 則與 Node.js 一起包成一個可執行檔，所以可以用於沒有安裝 Node.js 的系統上。

npm install -g pnpm

或

npm install -g @pnpm/exe

使用 Homebrew

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

brew install pnpm

使用 winget 來安裝

如果您已安裝 winget，可以使用此命令來安裝 pnpm

winget install pnpm

使用 Scoop

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

scoop install nodejs-lts pnpm

使用 Choco 來安裝

如果您已安裝 Choco，可以使用此命令來安裝 pnpm

choco install pnpm

使用 Volta 來安裝

如果您已安裝 Volta，可以使用此命令來安裝 pnpm

volta install pnpm

提示

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

相容性

此表列出過去的 pnpm 與對應 Node.js 版本的相容性：

Node.js	pnpm 7	pnpm 8	pnpm 9
Node.js 12	❌	❌	❌
Node.js 14	✔️	❌	❌
Node.js 16	✔️	✔️	❌
Node.js 18	✔️	✔️	✔️
Node.js 20	✔️	✔️	✔️

疑難排解

如果 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 命令的位置，例如：

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

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

使用較短的別名

輸入 pnpm 太麻煩嗎？您可以改用 pn 作為別名。

在 POSIX 系統中加入永久別名

將這行加入 shell 的設定檔 .bashrc、.zshrc 或 config.fish 就完成了：

alias pn=pnpm

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

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

notepad $profile.AllUsersAllHosts

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

set-alias -name pn -value pnpm

存檔後關閉視窗。您可能還需要關閉所有開啟的 Powershell 視窗，才能使設定生效。

解除安裝 pnpm

如果需要從系統中移除 pnpm 及其寫入磁碟的所有檔案，請參閱解除安裝 pnpm。

必要條件​

使用指令稿來安裝​

Windows​

POSIX 系統​

在 Docker 容器中​

安裝特定版本​

使用 Corepack 來安裝​

使用 npm 來安裝​

使用 Homebrew​

使用 winget 來安裝​

使用 Scoop​

使用 Choco 來安裝​

使用 Volta 來安裝​

相容性​

疑難排解​

使用較短的別名​

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

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

解除安裝 pnpm​