跳至主要內容
版本: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 上

curl -fsSL "https://github.com/pnpm/pnpm/releases/latest/download/pnpm-linuxstatic-x64" -o /bin/pnpm; chmod +x /bin/pnpm;

必要條件

若不想使用指令碼來安裝 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

此命令會自動在您的系統上安裝 pnpm。 然而,它可能不是最新版本的 pnpm。 若要升級,請檢查最新的 pnpm 版本,然後執行:

corepack prepare pnpm@<version> --activate

使用 Node.js v16.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 命令的位置,例如:

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

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

使用較短的別名

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

在 POSIX 系統中加入永久別名

將下面這行命令加入 .bashrc.zshrcconfig.fish 就完成了:

alias pn=pnpm

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

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

notepad $profile.AllUsersAllHosts

接著會打開 profile.ps1 檔案,加上:

set-alias -name pn -value pnpm

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

解除安裝 pnpm

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