Installazione

Usando uno script standalone

You may install pnpm even if you don't have Node.js installed, using the following scripts.

On Windows

Using PowerShell:

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

On POSIX systems

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

Se non hai curl installato, puoi usare wget:

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

On Alpine Linux

curl -fsSL "https://github.com/pnpm/pnpm/releases/latest/download/pnpm-linuxstatic-x64" -o /bin/pnpm; chmod +x /bin/pnpm;

Prerequisites

If you don't use the standalone script to install pnpm, then you need to have Node.js (at least v14) to be installed on your system.

Installing a specific version

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 -

tip

Puoi utilizzare poi il comando pnpm env per installare Node.js.

Utilizzo di Corepack

Dalla versione 16.13, Node.js fornisce Corepack per la gestione dei gestori di pacchetti. Questa è una funzionalità sperimentale, quindi è necessario abilitarla eseguendo:

corepack enable

Questo installerà automaticamente pnpm sul tuo sistema. Tuttavia, probabilmente non sarà l'ultima versione di pnpm. Per aggiornarlo, controlla qual è l'ultima versione di pnpm ed esegui:

corepack prepare pnpm@<version> --activate

With Node.js v16.17 or newer, you may install the latest version of pnpm by just specifying the tag:

corepack prepare pnpm@latest --activate

Usando npm

npm install -g pnpm

Usando Homebrew

Se il gestore di pacchetti è installato, è possibile installare pnpm utilizzando il seguente comando:

brew install pnpm

Usando Scoop

Se hai installato Scoop, puoi installare pnpm usando il seguente comando:

scoop install nodejs-lts pnpm

tip

Vuoi usare pnpm su server CI? Vedi: Integrazione vontinua.

Compatibilità

Di seguito è riportato un elenco delle versioni precedenti di pnpm con le rispettive versioni di Node.js supportate.

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	?️	?️	✔️	✔️

Risoluzione dei problemi

Se pnpm è danneggiato e non puoi risolvere reinstallando, potrebbe esser necessario rimuoverlo manualmente dal PATH.

Supponiamo di aver il seguente errore durante l'esecuzione di 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: []
}

Per prima cosa, prova a trovare il percorso di installazione di pnpm eseguendo: which pnpm. Se sei su Windows, esegui questo comando usando Git Bash. Otterrai il percorso di installazione del comando pnpm, ad esempio:

$ which pnpm
/c/Program Files/nodejs/pnpm

Ora che sai dove si trova la CLI pnpm, apri la cartella e rimuovi qualsiasi file relativo a pnpm (pnpm.cmd, pnpx.cmd, pnpm, ecc). Una volta fatto, installa nuovamente pnpm e dovrebbe funzionare come previsto.

Utilizzo di un alias più breve

pnpm potrebbe essere difficile da digitare, quindi è possibile utilizzare invece un alias più breve come pn.

Adding a permanent alias on POSIX systems

Basta inserire la seguente riga nel tuo .bashrc, .zshrco config.fish:

alias pn=pnpm

Adding a permanent alias in Powershell (Windows):

In a Powershell window with admin rights, execute:

notepad $profile.AllUsersAllHosts

In the profile.ps1 file that opens, put:

set-alias -name pn -value pnpm

Save the file and close the window. You may need to close any open Powershell window in order for the alias to take effect.

Disinstallazione di pnpm

Se devi rimuovere la CLI di pnpm dal sistema e tutti i file che ha scritto sul disco, vedi Disinstallazione di pnpm.