インストール
前提条件
スタンドアロン スクリプトや@pnpm/exeを使用して pnpm をインストールしない場合は、システムに Node.js (少なくとも v16.14) をインストールする必要があります。
スタンドアロンスクリプトを使用する
Node.js がインストールされていない場合でも、次のスクリプトを使用して pnpm をインストールできます。
Windows の場合
PowerShell を使用:
iwr https://get.pnpm.io/install.ps1 -useb | iex
POSIX システムの場合
curl -fsSL https://get.pnpm.io/install.sh | sh -
curlがインストール されていない場合は、wgetを使用します。
wget -qO- https://get.pnpm.io/install.sh | sh -
Alpine Linux の場合
# bash
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.bashrc" SHELL="$(which bash)" bash -
# sh
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.shrc" SHELL="$(which sh)" sh -
# dash
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.dashrc" SHELL="$(which dash)" dash -
特定のバージョンのインストール
インストール スクリプトを実行する前に、オプションで環境変数 PNPM_VERSION を設定して、pnpm の特定のバージョンをインストールできます。
curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=<version> sh -
pnpm env コマンドを使用して Node.js をインストールできるようになります。
Corepack を使用する
Node.jsではv16.13以降、パッケージマネージャーを管理するために Corepackの提供を始めました。 これは実験的な機能であるため、次のコマンドを実行して有効にする必要があります。
Node.js を pnpm env でインストールした場合、Corepack はシステムにインストールされないため、別途インストールする必要があります。 #4029 を参照してください。
corepack enable
Homebrew を使用して Node.js をインストールした場合は、Corepack を個別にインストールする必要があります。
brew install corepack
これにより、システムにpnpmが自動的にインストールされます。 ただし、pnpmの最新バージョンではない可能性が高いです。 アップグレードするには、 最新のpnpmのバージョン を確認し、次のコマンドを実行します。
corepack prepare pnpm@<version> --activate
Node.js v16.17 以降では、latestタグを指定することで、最新バージョンの pnpm をインストールできます。
corepack prepare pnpm@latest --activate
npm を使用する
pnpm CLI には pnpm と @pnpm/exe という 2 つのパッケージが提供されています。
pnpmは通常バージョンのpnpmで、これは実行にNode.jsが必要です。@pnpm/exeはNode.jsと一緒に実行可能ファイルにパッケージ化されているため、Node.jsがインストールされていないシステムで使用可能です。
npm install -g pnpm
または
npm install -g @pnpm/exe
Homebrew を使用する
パッケージマネージャーがインストールされている場合は、次のコマンドを使用してpnpmをインストールできます。
brew install pnpm
wingetを使用する
Wingetがインストールされている場合は、次のコマンドを使用してpnpmをインストールできます。
winget install pnpm
Scoop を使用する
Scoop がインストールされている場合は、次のコマンドを使用してpnpmをインストールできます。
scoop install nodejs-lts pnpm
Chocoの使用
Chocolatey がインストールされている場合は、次のコマンドを使用して pnpm をインストールできます。
choco install pnpm
Voltaを使用する
Volta がインストールされている場合は、次のコマンドを使用してpnpmをインストールできます。
volta install pnpm
CI サーバーで pnpm を使用したいですか？ こちらをご覧ください: Continuous Integration
互換性
これは、過去の pnpm バージョンとそれぞれの pnpm でサポートされている Node.js バージョンのリストです。
| Node.js | pnpm 5 | pnpm 6 | pnpm 7 | pnpm 8 |
|---|---|---|---|---|
| Node.js 12 | ✔️ | ✔️ | ❌ | ❌ |
| Node.js 14 | ✔️ | ✔️ | ✔️ | ❌ |
| Node.js 16 | ?️ | ✔️ | ✔️ | ✔️ |
| Node.js 18 | ?️ | ✔️ | ✔️ | ✔️ |
| Node.js 20 | ?️ | ? | ✔️ | ✔️ |
トラブルシューティング
pnpm が壊れていて、再インストールしても修正できない場合は、PATH から手動で削除する必要があるかもしれません。
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: []
}
まず、 which pnpm を実行して、pnpm がどこにあるか探してください。 Windows を使用している場合は、Git Bash を使用して以下のコマンドを実行します。 pnpm コマンドの場所が表示されます。次のように表示されるでしょう。
$ which pnpm
/c/Program Files/nodejs/pnpm
これで、 pnpm の CLI がどこにあるかが分かりました。そのディレクトリを開き、 pnpm 関連ファイル (pnpm.cmd、 pnpx.cmd、 pnpm など) を削除します。 完了したら、pnpm を再度インストールしましょう。期待どおりに動作するはずです。
短いエイリアスを使用する
pnpm は入力するのが難しいかもしれないので、代わりにpn のような短いエイリアスを使うことができます。
POSIX システムでの永続的なエイリアスの追加
次のコードを .bashrc, .zshrc, config.fishに追記するだけです。
alias pn=pnpm
Powershell (Windows) に永続的なエイリアスを追加
管理者権限を持つ Powershell ウィンドウで、次のコマンドを実行します。
notepad $profile.AllUsersAllHosts
profile.ps1 ファイルが開きますので、次のように入力します。
set-alias -name pn -value pnpm
ファイルを保存して、ウィンドウを閉じます。 エイリアスを有効にするために、開いている PowerShell ウィンドウを一度全て閉じる必要があるかもしれません。
pnpmをアンインストールする
pnpm CLI と pnpm が書き込んだ全てのファイルを削除する必要がある場合は、 pnpm のアンインストールを参照してください。