Перейти до основного змісту
Версія: 9.x

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

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

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​

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

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

Due to this issue, we currently recommend installing pnpm using npm or Corepack on Windows.

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

Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression

В системах POSIX​

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

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

wget -qO- https://get.pnpm.io/install.sh | 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​

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

If you installed Node.js using Homebrew, you'll need to install corepack separately:

brew install corepack

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

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

corepack use pnpm@latest

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.

  • pnpm is an ordinary version of pnpm, which needs Node.js to run.
  • @pnpm/exe is packaged with Node.js into an executable, so it may be used on a system with no Node.js installed.
npm install -g pnpm

або

npm install -g @pnpm/exe

Використовуючи 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.jspnpm 7pnpm 8pnpm 9
Node.js 12❌❌❌
Node.js 14✔️❌❌
Node.js 16✔️✔️❌
Node.js 18✔️✔️✔️
Node.js 20✔️✔️✔️

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

Якщо 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. If you're on Windows, run where.exe pnpm.* You'll get the location of the pnpm command, for instance:

$ 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.