Pular para o conteúdo principal
Version: Next

Instalação

Usando um script

Node.js is not preinstalled

On POSIX systems, you may install pnpm even if you don't have Node.js installed, using the following script:

curl -fsSL https://get.pnpm.io/install.sh | sh -

If you don't have curl installed, you would like to use wget:

wget -qO- https://get.pnpm.io/install.sh | sh -

No Windows (PowerShell):

iwr https://get.pnpm.io/install.ps1 -useb | iex

You may use the pnpm env command then to install Node.js.

Node.js is preinstalled

On Linux or macOS:

curl -f https://get.pnpm.io/v6.16.js | node - add --global pnpm

No Windows (PowerShell):

Invoke-WebRequest 'https://get.pnpm.io/v6.16.js' -UseBasicParsing -o pnpm.js; node pnpm.js add --global pnpm; Remove-Item pnpm.js

O script é assinado. Veja como verificar.

Using Corepack

Since v16.13, Node.js is shipping Corepack for managing package managers. This is an experimental feature, so you need to enable it by running:

corepack enable

This will automatically install pnpm on your system. However, it probably won't be the latest version of pnpm. To upgrade it, check what is the latest pnpm version and run:

corepack prepare pnpm@6.22.2 --activate

Usando npm

npm install -g pnpm

Usando npx

npx pnpm add -g pnpm

Atualizando

Once you have installed pnpm, there is no need to use other package managers to update it. You can upgrade pnpm using itself, like so:

pnpm add -g 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.jspnpm 1pnpm 2pnpm 3pnpm 4pnpm 5pnpm 6
Node.js 4✔️
Node.js 6✔️✔️
Node.js 8✔️✔️✔️
Node.js 10✔️✔️✔️✔️✔️
Node.js 12✔️✔️✔️✔️
Node.js 14✔️✔️✔️✔️
Node.js 16???️?️?️✔️

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.

Uninstalling pnpm

Se você precisar remover o pnpm de seu sistema, assim como quaisquer arquivos relacionados, veja Desinstalando pnpm.