版本：8.x

安装

前言

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

使用独立脚本安装

即使没有安装 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_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 来管理包管理器。这是一项实验性功能，因此您需要通过运行如下脚本来启用它：

提示

如果您已使用pnpm env安装Node.js，则Corepack不会被安装在您的系统上，您需要单独安装它。见#4029。

corepack enable

如果您已经使用Homebrew安装了Node.js，您需要单独安装Corepack：

brew install corepack

这会自动将pnpm安装在您的系统上。然而，这可能不是最新版本的 pnpm 。若要升级，请查阅latest pnpm version 并运行：

corepack prepare pnpm@<version> --activate

使用 Node.js v16.17 或更高版本，您只需指定标签即可安装 latest 版本的 pnpm ：

corepack prepare pnpm@latest --activate

使用 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 安装

如果您已经安装了这个包管理器，您可以使用下面的命令安装pnpm：

brew install pnpm

使用winget安装

如果您安装了 winget ，您可以使用以下命令安装 pnpm：

winget install 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 5	pnpm 6	pnpm 7	pnpm 8
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 pnpm 来找到 pnpm 的位置。如果您使用的是 Windows，请在 Git Bash 中运行此命令。您将获得 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。

前言​

使用独立脚本安装​

Windows​

在 POSIX 系统上​

在 Alpine Linux 上​

安装特定版本​

使用 Corepack 安装​

使用 npm 安装​

使用 HomeBrew 安装​

使用winget安装​

使用 Scoop 安装​

使用 Choco安装​

使用 Volta​

兼容性​

疑难解答​

使用较短的别名​

在 POSIX 系统上添加永久别名​

在 Powershell (Windows) 中添加永久别名：​

卸载 pnpm​

前言