Pular para o conteúdo principal
Versão: Next

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

Você gostaria de utilizar o pnpm em servidores de Integração Contínua (CI)? Veja Integração contínua.

Compatibilidade

Aqui está uma lista de versões anteriores do pnpm com suas respectivas versões do Node.js suportadas.

Node.jspnpm 4pnpm 5pnpm 6pnpm 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

Se você precisar remover a CLI do pnpm de seu sistema operacional, assim como quaisquer arquivos que ele tenha gravado em seu disco, consulte Desinstalando o pnpm.