Встановлення
Попередні вимоги
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
Використовуючи PowerShell:
$env:PNPM_VERSION = "9.15.5"; Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression
В системах POSIX
curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=9.15.5 sh -
Якщо у вас не встановлено curl, ви можете скористатися wget:
wget -qO- https://get.pnpm.io/install.sh | env PNPM_VERSION=9.15.5 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
Якщо ви встановили Node.js використовуючи Homebrew, вам потрібно буде встановити corepack окремо:
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
Якщо у вас встановлено менеджер пакунків, ви можете встановити pnpm за допомогою наступної команди:
brew install pnpm
Використовуючи winget
Якщо у вас встановлено winget, ви можете встановити pnpm за допомогою наступної команди:
winget install -e --id pnpm.pnpm
Використовуючи Scoop
Якщо у вас встановлено Scoop, ви можете встановити pnpm за допомогою наступної команди:
scoop install nodejs-lts pnpm
Використовуючи Choco
Якщо у вас встановлено Chocolatey, ви можете встановити pnpm за допомогою наступної команди:
choco install pnpm
Використовуючи Volta
Якщо у вас встановлено Volta, ви можете встановити pnpm за допомогою наступної команди:
volta install pnpm
Хочете використовувати pnpm на серверах CI? 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 не працює і ви не можете виправити це перевстановленням, можливо, вам доведеться видалити його вручну з 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.