Установка

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

If you don't use the standalone script or @pnpm/exe to install pnpm, then you need to have Node.js (at least v16.14) to be installed on your system.

Используя автономный скрипт

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

На Windows

С помощью PowerShell:

$env:PNPM_VERSION = "8.15.7"; iwr https://get.pnpm.io/install.ps1 -useb | iex

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

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

Если у вас не установлен curl, и вы хотели бы использовать wget:

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

В контейнере 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 -

совет

Затем вы можете использовать команду pnpm env для установки Node.js.

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-8

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@latest-8

или

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

С помощью Homebrew

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

brew install pnpm

Using winget

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

winget install 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 5	pnpm 6	pnpm 7	pnpm 8
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. Если вы используете Windows, запустите эту команду в Git Bash. Вы получите расположение команды pnpm, например:

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

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

Использование короткого алиаса

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.