版本：Next

安装指南

前提条件

如果你不使用独立脚本或 @pnpm/exe 来安装 pnpm，那么你需要在系统上安装 Node.js（至少 v18.12）。

使用独立脚本

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

在 Windows 上

注意

如果你使用这种方式安装 pnpm，Windows Defender 有时可能会阻止我们的可执行文件。

由于这个问题，我们目前建议在 Windows 上使用 npm 或 Corepack 来安装 pnpm。

使用 PowerShell：

Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression

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

安装特定版本

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

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

使用 Corepack

由于 Corepack 中的签名过期问题，应该先将 Corepack 更新到最新版本：

npm install --global corepack@latest

从 v16.13 开始，Node.js 附带了用于管理包管理器的 Corepack。这是一个实验性功能，你需要通过运行以下命令来启用它：

信息

如果你是使用 pnpm env 安装的 Node.js，你的系统上不会安装 Corepack，你需要单独安装它。参见 #4029。

corepack enable pnpm

这将自动在你的系统上安装 pnpm。

你可以使用以下命令来固定项目中使用的 pnpm 版本：

corepack use pnpm@latest-10

这会在你的本地 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@latest-10

或

npm install -g @pnpm/exe@latest-10

使用 Homebrew

如果你已安装该包管理器，可以使用以下命令安装 pnpm：

brew install pnpm

使用 winget

如果你已安装 winget，可以使用以下命令安装 pnpm：

winget install -e --id pnpm.pnpm

使用 Scoop

如果你已安装 Scoop，可以使用以下命令安装 pnpm：

scoop install nodejs-lts pnpm

使用 Choco

如果你已安装 Chocolatey，可以使用以下命令安装 pnpm：

choco install pnpm

使用 Volta

如果你已安装 Volta，可以使用以下命令安装 pnpm：

volta install pnpm

提示

想在 CI 服务器上使用 pnpm 吗？参见：持续集成。

兼容性

以下是过去的 pnpm 版本及其对应的 Node.js 版本支持列表。

Node.js	pnpm 8	pnpm 9	pnpm 10
Node.js 14	❌	❌	❌
Node.js 16	✔️	❌	❌
Node.js 18	✔️	✔️	✔️
Node.js 20	✔️	✔️	✔️
Node.js 22	✔️	✔️	✔️

疑难解答

如果 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 可能不太容易输入，所以你可以使用更短的别名，比如 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，运行 self-update 命令：

pnpm self-update

卸载 pnpm

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

前提条件​

使用独立脚本​

在 Windows 上​

在 POSIX 系统上​

在 Docker 容器中​

安装特定版本​

使用 Corepack​

使用其他包管理器​

使用 npm​

使用 Homebrew​

使用 winget​

使用 Scoop​

使用 Choco​

使用 Volta​

兼容性​

疑难解答​

使用更短的别名​

在 POSIX 系统上添加别名​

在 Powershell (Windows) 中添加别名​

更新 pnpm​

卸载 pnpm​