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.