Встановлення
Попередні вимоги
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.
Використання окремого скрипта
Ви можете встановити pnpm, навіть якщо у вас не встановлено Node.js, за допомогою наступних скриптів.
У Windows
Використовуючи PowerShell:
$env:PNPM_VERSION = "11.0.0-alpha.10"; Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression
У Windows Microsoft Defender може значно уповільнити встановлення пакунків. Ви можете додати pnpm до списку довірених тек Microsoft Defender у вікні PowerShell з правами адміністратора, виконавши:
Add-MpPreference -ExclusionPath $(pnpm store path)
В системах POSIX
curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=11.0.0-alpha.10 sh -
Якщо у вас не встановлено curl, ви можете скористатися wget:
wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=11.0.0-alpha.10 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 -
Встановлення конкретної версії
Prior to running the install script, you may optionally set an env variable PNPM_VERSION to install a specific version of pnpm:
curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=<version> sh -
Використовуючи Corepack
Через проблему з застарілими підписами на Corepack, Corepack слід спочатку оновити до останньої версії:
npm install --global corepack@latest
Since v16.13, Node.js is shipping Corepack for managing package managers. Це експериментальна функція, тому вам потрібно ввімкнути її, виконавши:
If you have installed Node.js with pnpm env Corepack won't be installed on your system, you will need to install it separately. See #4029.
corepack enable pnpm
Це автоматично встановить pnpm у вашій системі.
Ви можете закріпити версію pnpm, яка використовується у вашому проєкті, за допомогою наступної команди:
corepack use pnpm@next-11
This will add a "packageManager" field in your local package.json which will instruct Corepack to always use a specific version on that project. Це може бути корисно, якщо вам потрібна відтворюваність, оскільки всі розробники, які використовують Corepack, використовуватимуть ту саму версію, що й ви. Коли буде випущена нова версія pnpm, ви можете повторно запустити наведену вище команду.
Використання інших менеджерів пакунків
Використовуючи npm
We provide two packages of pnpm CLI, pnpm and @pnpm/exe.
pnpmis an ordinary version of pnpm, which needs Node.js to run.@pnpm/exeis packaged with Node.js into an executable, so it may be used on a system with no Node.js installed.
npx pnpm@next-11 dlx @pnpm/exe@next-11 setup
або
npm install -g pnpm@next-11
Використовуючи Homebrew
If you have the package manager installed, you can install pnpm using the following command:
brew install pnpm
Використовуючи winget
If you have winget installed, you can install pnpm using the following command:
winget install -e --id pnpm.pnpm
Використовуючи Scoop
If you have Scoop installed, you can install pnpm using the following command:
scoop install nodejs-lts pnpm
Використовуючи Choco
If you have Chocolatey installed, you can install pnpm using the following command:
choco install pnpm
Використовуючи Volta
If you have Volta installed, you can install pnpm using the following command:
volta install pnpm
Хочете використовувати pnpm на серверах CI? See: Continuous Integration.
Сумісність
Ось список останніх версій pnpm з відповідними версіями Node.js, які вони підтримують.
| Node.js | pnpm 8 | pnpm 9 | pnpm 10 | pnpm 11 |
|---|---|---|---|---|
| Node.js 14 | ❌ | ❌ | ❌ | ❌ |
| Node.js 16 | ✔️ | ❌ | ❌ | ❌ |
| Node.js 18 | ✔️ | ✔️ | ✔️ | ❌ |
| Node.js 20 | ✔️ | ✔️ | ✔️ | ❌ |
| Node.js 22 | ✔️ | ✔️ | ✔️ | ✔️ |
| Node.js 24 | ✔️ | ✔️ | ✔️ | ✔️ |
| Node.js 26 | ✔️ | ✔️ | ✔️ | ✔️ |
Усунення несправностей
Якщо pnpm не працює і ви не можете виправити це перевстановленням, можливо, вам доведеться видалити його вручну з PATH.
Let's assume you have the following error when running 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: []
}
First, try to find the location of pnpm by running: which pnpm. Якщо ви використовуєте Windows, запустіть where.exe pnpm.*.
Ви отримаєте розташування команди pnpm, наприклад:
$ which pnpm
/c/Program Files/nodejs/pnpm
Now that you know where the pnpm CLI is, open that directory and remove any pnpm-related files (pnpm.cmd, pnpx.cmd, pnpm, etc).
Після видалення, встановіть pnpm знову, і він повинен запрацювати, як очікувалося.
Використання скороченого псевдоніма
pnpm might be hard to type, so you may use a shorter alias like pn instead.
Додавання постійного псевдоніма у системах POSIX
Just put the following line to your .bashrc, .zshrc, or config.fish:
alias pn=pnpm
Додавання постійного псевдоніма в Powershell (Windows):
У вікні Powershell, виконайте з правами адміністратора:
notepad $profile.AllUsersAllHosts
In the profile.ps1 file that opens, put:
set-alias -name pn -value pnpm
Збережіть файл і закрийте вікно. Можливо, Вам доведеться закрити всі відкриті вікна Powershell, щоб псевдонім набув чинності.
Оновлення 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.