Instalação
Usando um script
Em sistemas POSIX, você pode instalar pnpm mesmo sem o Node.js instalado, usando o seguinte script:
curl -fsSL https://get.pnpm.io/install.sh | sh -
Se você não tiver curl instalado, poderá usar wget:
wget -qO- https://get.pnpm.io/install.sh | sh -
No Windows (PowerShell):
iwr https://get.pnpm.io/install.ps1 -useb | iex
Então, você pode utilizar o comando pnpm env para instalar Node.js.
Usando Corepack
Desde a versão v16.13, Node.js inclui Corepack para controlar a instalação de gerenciadores de pacotes. Esta é uma ferramenta experimental, então você precisa habilitá-la com o seguinte comando:
corepack enable
Isso irá automaticamente instalar pnpm no seu sistema. Entretanto, provavelmente não será a versão mais recente do pnpm. Para atualizá-lo, verifique a versão mais recente do pnpm e execute:
corepack prepare pnpm@<version> --activate
Usando npm
npm install -g pnpm
Usando Homebrew
Se você tiver o Homebrew instalado, poderá instalar pnpm usando o seguinte comando:
brew install pnpm
Usando Scoop
Se você tiver Scoop instalado, poderá instalar pnpm usando o seguinte comando:
scoop install nodejs-lts pnpm
tip
Do you wanna use pnpm on CI servers? See: Continuous Integration.
Compatibilidade
Here is a list of past pnpm versions with respective Node.js version support.
Node.js | pnpm 4 | pnpm 5 | pnpm 6 | pnpm 7 |
---|---|---|---|---|
Node.js 10 | ✔️ | ✔️ | ❌ | ❌ |
Node.js 12 | ✔️ | ✔️ | ✔️ | ❌ |
Node.js 14 | ✔️ | ✔️ | ✔️ | ✔️ |
Node.js 16 | ?️ | ?️ | ✔️ | ✔️ |
Node.js 18 | ?️ | ?️ | ✔️ | ✔️ |
Solução de Problemas
Se o pnpm falhar, e não for resolvido por meio de uma reinstalação, você pode precisar removê-lo manualmente do PATH.
Assumindo que você têm o seguinte erro ao rodar 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: []
}
Primeiro, tente encontrar a localização do pnpm rodando: which pnpm
. Se você usar Windows, execute este comando no Git Bash. Você irá ver a localização do comando pnpm, como:
$ which pnpm
/c/Program Files/nodejs/pnpm
Agora que você sabe onde está localizado o pnpm, abra este diretório e remova qualquer arquivo relacionado ao pnpm (pnpm.cmd
, pnpx.cmd
, pnpm
, etc). Então, instale o pnpm novamente, e ele deve funcionar como esperado.
Desinstalando o pnpm
If you need to remove the pnpm CLI from your system and any files it has written to your disk, see Uninstalling pnpm.