Встановлення

Попередні вимоги

Якщо ви не використовуєте окремий скрипт або @pnpm/exe для встановлення pnpm, то у вашій системі має бути встановлений Node.js (принаймні v22.).

інформація

Looking for pnpm 12? It is currently in beta and installed differently from pnpm 11. See Installing the pnpm 12 beta.

Використання окремого скрипта

Ви можете встановити pnpm, навіть якщо у вас не встановлено Node.js, за допомогою наступних скриптів.

У Windows

попередження

Іноді Windows Defender може заблокувати наш виконуваний файл, якщо ви встановлюєте pnpm у такий спосіб.

Через цю проблему ми рекомендуємо встановлювати pnpm за допомогою npm або Corepack у Windows.

Використовуючи PowerShell:

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

Not supported on Intel macOS in pnpm 11

On pnpm 11, the standalone script does not run on Intel Macs (darwin-x64). Use npm, Corepack, or Homebrew instead. See #11423 for context.

pnpm 12 ships an Intel macOS build again, so this limitation doesn't apply to it.

curl -fsSL https://get.pnpm.io/install.sh | sh -

Якщо у вас не встановлено curl, ви можете скористатися wget:

wget -qO- https://get.pnpm.io/install.sh | sh -

Linux runtime requirements

Скрипт встановлення обирає збірку glibc або musl залежно від libc вашої системи, і окрема збірка musl надається для Alpine та інших musl дистрибутивів. 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="$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

Через проблему з застарілими підписами на Corepack, Corepack слід спочатку оновити до останньої версії:

npm install --global corepack@latest

Починаючи з версії 16.13, Node.js постачає Corepack для керування менеджерами пакунків. Це експериментальна функція, тому вам потрібно ввімкнути її, виконавши:

інформація

Якщо ви встановили Node.js з pnpm runtime Corepack не буде встановлено у вашій системі, вам потрібно буде встановити його окремо. Див. #4029.

corepack enable pnpm

Це автоматично встановить pnpm у вашій системі.

Ви можете закріпити версію pnpm, яка використовується у вашому проєкті, за допомогою наступної команди:

corepack use pnpm@latest-11

Це додасть поле "packageManager" у ваш локальний package.json, яке вкаже Corepack завжди використовувати певну версію в цьому проєкті. Це може бути корисно, якщо вам потрібна відтворюваність, оскільки всі розробники, які використовують Corepack, використовуватимуть ту саму версію, що й ви. Коли буде випущена нова версія pnpm, ви можете повторно запустити наведену вище команду.

попередження

Corepack cannot install pnpm 12 yet. It expects the pnpm package to contain a bin/pnpm.mjs file, which the native pnpm 12 package does not have. Use pnpm self-update, npm, or the standalone script to install the beta.

Використання інших менеджерів пакунків

Використовуючи npm

Ми надаємо два пакунки pnpm CLI, pnpm та @pnpm/exe. On pnpm 12 the two are identical, so there is no reason to prefer one over the other; the difference below applies to pnpm 11.

• pnpm — це звичайна версія pnpm, для роботи якої потрібен Node.js. Починаючи з версії v11, pnpm розповсюджується як чистий ESM.
• @pnpm/exe упаковано разом з Node.js у виконуваний файл, тому його можна використовувати в системі без встановленого Node.js. On Linux, glibc and musl builds are both provided and the right one is selected automatically; the glibc build requires glibc 2.27 or newer and libatomic.so.1 (see Linux runtime requirements for details). Not available for Intel macOS (darwin-x64) — install pnpm instead, see #11423.

npx pnpm@latest-11 dlx @pnpm/exe@latest-11 setup

або

npm install -g pnpm@latest-11

Використовуючи 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

підказка

Хочете використовувати pnpm на серверах CI? Див.: Безперервна інтеграція.

Installing the pnpm 12 beta

попередження

pnpm 12 is a rewrite of pnpm in Rust and is currently in beta. It is not recommended for production use yet. Please report any issues you run into.

pnpm 12 has no intentional breaking changes compared to pnpm 11, so the rest of this documentation applies to both versions. Only installation differs while v12 is in beta: it is published under the next-12 tag on npm and as a prerelease on GitHub, so Homebrew, winget, Scoop and Chocolatey don't offer it yet.

Using pnpm

If you already have pnpm v11.10.0 or newer, this is the easiest way to switch:

pnpm self-update next-12

pnpm links the native binary directly, so nothing else is needed. Note that inside a project that pins pnpm through the packageManager field, self-update only updates that pin instead of installing pnpm globally.

Using npm

If you don't have pnpm installed yet:

npm install -g --allow-scripts=pnpm pnpm@next-12

інформація

--allow-scripts=pnpm is required on npm 11.16 and newer, which blocks install scripts by default. The published package is a small wrapper whose preinstall script replaces it with the native binary for your platform, so without the flag pnpm is left as a placeholder file that fails to run. Older versions of npm run install scripts anyway and ignore the flag, so the command above works on any version. For the same reason, don't install pnpm 12 with --ignore-scripts or --no-optional. If you install it with pnpm or Bun, allow the build scripts of the pnpm package.

Node.js 18 or newer is needed to run that install script, but not to run pnpm afterwards — pnpm 12 is a native binary.

Using a standalone script

Set PNPM_VERSION to the exact beta version (the POSIX script does not accept npm dist-tags).

On POSIX systems:

curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=12.0.0-beta.2 sh -

On Windows, using PowerShell:

$env:PNPM_VERSION="12.0.0-beta.2"; Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression

This installs pnpm without requiring Node.js, and unlike pnpm 11 it also works on Intel macOS.

Сумісність

Ось список останніх версій pnpm з відповідними версіями Node.js, які вони підтримують.

Node.js	pnpm 8	pnpm 9	pnpm 10	pnpm 11	pnpm 12
Node.js 14	❌	❌	❌	❌	❌
Node.js 16	✔️	❌	❌	❌	❌
Node.js 18	✔️	✔️	✔️	❌	✔️
Node.js 20	✔️	✔️	✔️	❌	✔️
Node.js 22	✔️	✔️	✔️	✔️	✔️
Node.js 24	✔️	✔️	✔️	✔️	✔️
Node.js 26	✔️	✔️	✔️	✔️	✔️

pnpm 12 only needs Node.js when it is installed from npm; the version installed by the standalone script runs without Node.js.

Усунення несправностей

Якщо 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

Щоб оновити pnpm, виконайте команду self-update:

pnpm self-update

Видалення pnpm

Якщо вам потрібно видалити pnpm CLI з вашої системи та всі файли, які він записав на диск, див. розділ Видалення pnpm.