Встановлення
Попередні вимоги#
pnpm 12 is a native executable and does not require Node.js after it is installed. The pnpm npm package installs on Node.js 18 or newer. The npx get-pnpm installer requires Node.js 22.13 or newer.
pnpm 12 is the current release line. The latest tag on npm points at it, so the commands below install pnpm 12 without naming a version.
Supported platforms#
pnpm 12 ships a prebuilt binary for each of these targets:
| Operating system | Architectures |
|---|---|
| Linux (glibc) | x64, arm64, riscv64, ppc64le, s390x |
| Linux (musl) | x64, arm64 |
| macOS | arm64, x64 |
| Windows | x64, arm64 |
| FreeBSD | x64 |
| NetBSD | x64 |
| Android | arm64, x64 |
FreeBSD, ppc64le, s390x, RISC-V, and Android were added in v12.4.0. The NetBSD binary is built and tested on NetBSD 10. On a target with no binary, install the JavaScript pnpm 11 instead.
For StackBlitz WebContainers, see the experimental WebAssembly distribution.
Using pnpm#
If you already have pnpm v11.10.0 or newer, update directly to pnpm 12:
pnpm self-update
Inside a project that pins pnpm through the packageManager field, self-update only updates that pin instead of installing pnpm globally.
Використання окремого скрипта#
Ви можете встановити pnpm, навіть якщо у вас не встановлено Node.js, за допомогою наступних скриптів.
У Windows#
попередження
Іноді Windows Defender може заблокувати наш виконуваний файл, якщо ви встановлюєте pnpm у такий спосіб.
Due to this issue, we currently recommend installing pnpm using npm on Windows.
Використовуючи PowerShell:
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#
curl -fsSL https://get.pnpm.io/install.sh | sh -
Якщо у вас не встановлено curl, ви можете скористатися wget:
wget -qO- https://get.pnpm.io/install.sh | sh -
підказка
Після цього ви можете скористатися командою pnpm runtime для встановлення Node.js.
У контейнері Docker#
# bash
wget -qO- https://get.pnpm.io/install.sh | env ENV="$HOME/.bashrc" SHELL="$(which bash)" bash -
# sh
wget -qO- https://get.pnpm.io/install.sh | env ENV="$HOME/.shrc" SHELL="$(which sh)" sh -
# dash
wget -qO- https://get.pnpm.io/install.sh | env 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
Node.js 22.13 or newer is needed to run this installer, but not to run pnpm afterwards.
You can also install the pnpm package globally with npm, which needs Node.js 18 or newer:
npm install -g pnpm@latest
підказка
Хочете використовувати pnpm на серверах CI? Див.: Безперервна інтеграція.
Сумісність#
Here is a list of the supported pnpm versions with respective Node.js version support.
| Node.js | pnpm 10 | pnpm 11 | pnpm 12 |
|---|---|---|---|
| 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.
For example, a leftover install of an older, JavaScript-based pnpm earlier on PATH can shadow pnpm 12 and fail like this 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: []
}
Спочатку спробуйте знайти розташування 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.