跳到主要内容

安装

前言​

If you don't use the standalone script or @pnpm/exe to install pnpm, then you need to have Node.js (at least v18.12) to be installed on your system.

使用独立脚本安装​

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

Windows​

注意

Sometimes, Windows Defender may block our executable if you install pnpm this way.

Due to this issue, we currently recommend installing pnpm using npm or Corepack on Windows.

使用 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 -
提示

You may use the pnpm env command then to install Node.js.

In a Docker container​

# 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 安装​

从 v16.13 开始，Node.js 发布了 Corepack 来管理包管理器。 这是一项实验性功能，因此您需要通过运行如下脚本来启用它：

信息

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

corepack enable pnpm

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

brew install corepack

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

你可以通过下列命令固定项目所用的 pnpm 版本：

corepack use pnpm@latest

这会添加一个 packageManager 字段到您本地的 package.json，指示 Corepack 始终在该项目上使用特定的版本。 如果您想要可复现性，这可能很有用，因为所有使用 Corepack 的开发人员都将使用与您相同的版本。 当一个新版本的 pnpm 发布时，您可以重新运行上述命令。

Using other package managers​

使用 npm 安装​

我们提供了两个 pnpm CLI 包， pnpm 和 @pnpm/exe。

  • pnpm is an ordinary version of pnpm, which needs Node.js to run.
  • @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 -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.jspnpm 7pnpm 8pnpm 9
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 的位置。 If you're on Windows, run where.exe pnpm.* You'll get the location of the pnpm command, for instance:

$ 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 窗口才能使别名生效。

Updating pnpm​

To update pnpm, run the self-update command:

pnpm self-update

卸载 pnpm​

If you need to remove the pnpm CLI from your system and any files it has written to your disk, see Uninstalling pnpm.