版本：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 上

# 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，那么您需要在您的系统上安装 Node.js（至少 v14）。

安装特定版本

在运行安装脚本之前，您可以选择设置环境变量 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

如果您使用 Homebrew 安装了 Node.js，则需要单独安装 corepack：

brew install corepack

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

corepack prepare pnpm@<version> --activate

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

corepack prepare pnpm@latest --activate

使用 npm 安装

npm install -g pnpm

使用 HomeBrew 安装

如果您安装了包管理器，则可以使用以下命令安装 pnpm：

brew install pnpm

使用 Scoop 安装

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

scoop install nodejs-lts pnpm

提示

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

兼容性

pnpm 的各个版本对 Node.js 的兼容性表格：

Node.js	pnpm 4	pnpm 5	pnpm 6	pnpm 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 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 安装​

使用 Scoop 安装​

兼容性​

问题排查​

使用更短的别名​

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

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

卸载 pnpm​