Встановлення
Попередні вимоги#
Якщо ви не використовуєте окремий скрипт або @pnpm/exe для встановлення pnpm, то у вашій системі має бути встановлений Node.js (принаймні v22.).
Використання окремого скрипта#
Ви можете встановити pnpm, навіть якщо у вас не встановлено Node.js, за допомогою наступних скриптів.
У Windows#
попередження
Іноді Windows Defender може заблокувати наш виконуваний файл, якщо ви встановлюєте pnpm у такий спосіб.
Due to this issue, we currently recommend installing pnpm using npm on Windows.
Використовуючи PowerShell:
$env:PNPM_VERSION="latest-11"; Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression
On Windows, Microsoft Defender can slow down installation of packages. Ви можете додати pnpm до списку довірених тек Microsoft Defender у вікні PowerShell з правами адміністратора, виконавши:
Add-MpPreference -ExclusionPath $(pnpm store path)
В системах POSIX#
Not supported on Intel macOS and arm64 musl Linux
The standalone script and @pnpm/exe do not run on Intel Macs (darwin-x64) or on arm64 musl Linux, such as Alpine on ARM. Install the pnpm package, which runs on your system Node.js, with npm install -g pnpm@latest-11 instead. On arm64 musl Linux you can also use pnpm 12, which has a native binary for it. See #11423 and #10443 for context.
curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-11 sh -
Якщо у вас не встановлено curl, ви можете скористатися wget:
wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-11 sh -
Linux runtime requirements
The install script picks a glibc or musl build based on your system's libc. A separate musl build is provided for Alpine and other musl-based distros on x64. The glibc build requires glibc 2.27 or newer plus libatomic.so.1. Both are present on most full distros but may be missing from minimal container images. If you see error while loading shared libraries: libatomic.so.1, install it with your distro's package manager:
- Debian/Ubuntu:
apt-get install -y libatomic1 - Fedora/RHEL:
dnf install -y libatomic
підказка
Після цього ви можете скористатися командою pnpm runtime для встановлення Node.js.
У контейнері Docker#
# bash
wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-11 ENV="$HOME/.bashrc" SHELL="$(which bash)" bash -
# sh
wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-11 ENV="$HOME/.shrc" SHELL="$(which sh)" sh -
# dash
wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=latest-11 ENV="$HOME/.dashrc" SHELL="$(which dash)" dash -
Встановлення конкретної версії#
Before 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 -
Використовуючи npm#
npx get-pnpm latest-11
підказка
Хочете використовувати pnpm на серверах CI? Див.: Безперервна інтеграція.
Сумісність#
Ось список останніх версій 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.
Припустимо, у вас виникає подібна проблема під час запуску 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, запустіть where.exe pnpm.*.
Ви отримаєте розташування команди pnpm, наприклад:
$ which pnpm
/c/Program Files/nodejs/pnpm
Тепер, коли ви знаєте, де знаходиться pnpm CLI, відкрийте цю теку і видаліть усі файли, повʼязані з pnpm (pnpm.cmd, pnpx.cmd, pnpm і т.д.).
Після видалення, встановіть pnpm знову, і він повинен запрацювати, як очікувалося.
Оновлення pnpm#
To update to the newest pnpm 11, run the self-update command with the major:
pnpm self-update 11
A bare pnpm self-update follows npm's latest tag, which now points at pnpm
12. See Installing pnpm v12 if that
is what you want.
Видалення pnpm#
Якщо вам потрібно видалити pnpm CLI з вашої системи та всі файли, які він записав на диск, див. розділ Видалення pnpm.