Установка

Предварительные условия

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.

Using a standalone script

You may install pnpm even if you don't have Node.js installed, using the following scripts.

На Windows

warning

Sometimes, Windows Defender may block our executable if you install pnpm this way.

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

Using PowerShell:

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

На POSIX-системах

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

If you don't have curl installed, you would like to use wget:

wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=10.0.0 sh -

совет

You may use the pnpm env command then to install 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 -

Using Corepack

Начиная с версии 16.13, Node.js предоставляет возможность использовать Corepack для управления менеджерами пакетов. Это экспериментальная возможность, поэтому вам необходимо включить её, запустив:

инфо

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 в вашу систему.

You can pin the version of pnpm used on your project using the following command:

corepack use pnpm@latest-10

This will add a "packageManager" field in your local package.json which will instruct Corepack to always use a specific version on that project. This can be useful if you want reproducability, as all developers who are using Corepack will use the same version as you. When a new version of pnpm is released, you can re-run the above command.

Using other package managers

Using npm

Мы предоставляем два пакета pnpm CLI, pnpm и @pnpm/exe.

• pnpm is an ordinary version of pnpm, which needs Node.js to run.
• @pnpm/exe упакован с Node.js в исполняемый файл, поэтому он может быть использован в системе без установки Node.js.

npm install -g pnpm@latest-10

или

npm install -g @pnpm/exe@latest-10

С помощью Homebrew

Если на вашем устройстве установлен менеджер пакетов Homebrew, то вы можете установить pnpm следующей командой:

brew install pnpm

Using winget

Если у вас установлен winget, вы можете установить pnpm, используя следующую команду:

winget install -e --id pnpm.pnpm

Using Scoop

Если у вас установлен Scoop, вы можете установить pnpm с помощью следующей команды:

scoop install nodejs-lts pnpm

Using Choco

Если у вас установлен Chocolatey, можно установить pnpm с помощью следующей команды:

choco install pnpm

Using Volta

Если вы установили Volta, то вы можете установить pnpm с помощью следующей команды:

volta install pnpm

совет

Хотите использовать pnpm в CI/CD? See: Continuous Integration.

Совместимость

Ниже перечислены предыдущие версии pnpm с поддержкой версий Node.js.

Node.js	pnpm 8	pnpm 9	pnpm 10
Node.js 14	❌	❌	❌
Node.js 16	✔️	❌	❌
Node.js 18	✔️	✔️	✔️
Node.js 20	✔️	✔️	✔️
Node.js 22	✔️	✔️	✔️

Решение проблем

Если pnpm по какой-то причине не работает, и у вас не получается решить проблему переустановив его, возможно вам нужно самостоятельно удалить 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. If you're on Windows, run where.exe pnpm.*. Вы получите расположение команды pnpm, например:

$ which pnpm
/c/Program Files/nodejs/pnpm

Теперь, когда вы знаете, где находится CLI pnpm, откройте эту папку и удалите все связанные с pnpm файлы (pnpm.cmd, pnpx.cmd, pnpm и т.д.). После этого установите pnpm еще раз, и он должен работать как вы того ожидаете.

Using a shorter alias

pnpm может быть трудно ввести, поэтому вы можете использовать более короткий алиас, например pn.

Добавление постоянного алиаса на POSIX системах

Просто добавьте следующую строку в ваш .bashrc, .zshrc или config.fish:

alias pn=pnpm

Добавление постоянного алиаса в PowerShell (Windows):

В окне PowerShell с правами администратора выполните:

notepad $profile.AllUsersAllHosts

В открывшимся файле profile.ps1 добавьте:

set-alias -name pn -value pnpm

Сохраните этот файл и закройте окно. Вам может потребоваться закрыть все открытые окна PowerShell, чтобы алиас вступил в силу.

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