安装

先决条件

pnpm 12 是一个原生可执行文件，安装后不需要 Node.js。通过 npm 安装它则需要 Node.js 22.13 或更新版本。

npm 上未加限定的 latest 标签仍指向 pnpm 11。安装 pnpm 12 时请使用 latest-12 标签。

使用 pnpm

如果你已经拥有 pnpm v11.10.0 或更新版本，可直接更新到 pnpm 12：

pnpm self-update latest-12

在通过 packageManager 字段锁定 pnpm 的项目内，self-update 只会更新该锁定值，而不会全局安装 pnpm。

使用独立脚本

即使没有安装 Node.js，你也可以使用以下脚本安装 pnpm。

在 Windows 上

使用 PowerShell：

$env:PNPM_VERSION="latest-12"; Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression

在 Windows 上，Microsoft Defender 会显著拖慢包的安装。你可以在具有管理员权限的 PowerShell 窗口中，通过执行以下命令把 pnpm 加入 Microsoft Defender 的排除文件夹列表：

Add-MpPreference -ExclusionPath $(pnpm store path)

在 POSIX 系统上

curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-12 sh -

如果你没有安装 curl，可以使用 wget：

wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-12 sh -

在 Docker 容器中

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

安装特定版本

在运行安装脚本之前，你可以选择设置环境变量 PNPM_VERSION 来安装 pnpm 的特定版本：

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

使用 npm

npx get-pnpm latest-12

运行此安装程序需要 Node.js 22.13 或更新版本，但之后运行 pnpm 并不需要。

兼容性

以下是历次 pnpm 版本及其 Node.js 版本支持的列表。

Node.js	pnpm 8	pnpm 9	pnpm 10	pnpm 11	pnpm 12
Node.js 14	❌	❌	❌	❌	❌
Node.js 16	✔️	❌	❌	❌	❌
Node.js 18	✔️	✔️	✔️	❌	✔️
Node.js 20	✔️	✔️	✔️	❌	✔️
Node.js 22	✔️	✔️	✔️	✔️	✔️
Node.js 24	✔️	✔️	✔️	✔️	✔️
Node.js 26	✔️	✔️	✔️	✔️	✔️

pnpm 12 只有在从 npm 安装时才需要 Node.js；由独立脚本安装的版本无需 Node.js 即可运行。

故障排查

如果 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 pnpm 找到 pnpm 的位置。如果你在 Windows 上，运行 where.exe pnpm.*。你会得到 pnpm 命令的位置，例如：

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

现在你知道了 pnpm CLI 所在的位置，打开该目录并移除所有 pnpm 相关文件（pnpm.cmd、pnpx.cmd、pnpm 等）。完成后，重新安装 pnpm，它应该就能正常工作。

更新 pnpm

要更新 pnpm，运行 self-update 命令：

pnpm self-update

卸载 pnpm

如果你需要从系统中移除 pnpm CLI 以及它写入磁盘的任何文件，参见卸载 pnpm。