Установка

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

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

Using PowerShell:

iwr https://get.pnpm.io/install.ps1 -useb | iex

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

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

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

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

совет

Затем вы можете использовать команду pnpm env для установки 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

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

brew install corepack

Это автоматически установит pnpm в вашу систему.

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

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

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

• pnpm - обычная версия pnpm, для запуска которой нужен Node.js.
• @pnpm/exe упакован с Node.js в исполняемый файл, поэтому он может быть использован в системе без установки Node.js.

npm install -g pnpm

или

npm install -g @pnpm/exe

С помощью 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 7	pnpm 8	pnpm 9
Node.js 12	❌	❌	❌
Node.js 14	✔️	❌	❌
Node.js 16	✔️	✔️	❌
Node.js 18	✔️	✔️	✔️
Node.js 20	✔️	✔️	✔️

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

Если 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.* You'll get the location of the pnpm command, for instance:

$ 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, чтобы алиас вступил в силу.

Удаление pnpm

Если вам нужно удалить pnpm CLI из вашей системы и все файлы связанные с ним, см. Удаление pnpm.