跳至主要内容
版本: 9.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 -
提示

您可以使用 pnpm env 命令来安装 Node.js。

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

这将在您的本地 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

或者

npm install -g @pnpm/exe
提示

您想在 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: []
}

首先，尝试通过运行以下命令来查找 pnpm 的位置：which 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。