できない.dev

pnpm: command not found で pnpm コマンドが実行できない

pnpm: command not found は、未インストールか Corepack 未有効、または PNPM_HOME が PATH に無いのが原因。
Corepack を有効化するのが最も手軽で再現性も高い(Node 25 以降は Corepack の別途インストールが必要)。

公開: 更新:

症状できない · exit 127
pnpm --version
bash: line 1: pnpm: command not found
解決後できた · exit 0
pnpm --version
Downloading the pnpm 12.10.1 binary for linux-x64...
12.10.1

2026-10-10 に node:20(pnpm 12.10.1 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

pnpm: command not found(zsh では zsh: command not found: pnpm)は、シェルが pnpm の実行ファイルを見つけられないときに出る。
原因は、未インストールか、Corepack を有効化していないか、スタンドアロン版の PNPM_HOME を PATH に通していないかのいずれかである。
Corepack を使うのが最も手軽で、プロジェクト間のバージョン固定もできる(Node 24 までは同梱、25 以降は別途インストール)。

実行例

pnpm が入っていない bash では pnpm: command not found で終了コード 127 になった。
corepack enable pnpm でも npm install -g pnpm でも、同じ pnpm --version が 12.10.1 で通っている。
スタンドアロンスクリプトで入れた直後は同じシェルではまだ見つからず、source ~/.bashrc で PNPM_HOME を読み込むと通った。

$ pnpm --version
bash: line 1: pnpm: command not found
$ echo $?
127
$ corepack enable pnpm
$ pnpm --version
Downloading the pnpm 12.10.1 binary for linux-x64...
12.10.1
$ echo $?
0
$ pnpm --version
bash: line 1: pnpm: command not found
$ echo $?
127
$ npm install -g pnpm
added 2 packages in 2s
npm notice
npm notice New major version of npm available! 10.8.2 -> 12.2.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.2.0
npm notice To update run: npm install -g npm@12.2.0
npm notice
$ pnpm --version
12.10.1
$ echo $?
0
$ curl -fsSL https://get.pnpm.io/install.sh | sh -
==> Downloading pnpm 12.10.1
Installing pnpm CLI globally from /tmp/tmp.qep6TjLgbi
.../global/v11/128-18dd0e9ceff42da8-0    | Progress: resolved 1, reused 0, downloaded 0, added 0
Packages are hard linked from the content-addressable store to the virtual store.
  Content-addressable store is at: /root/.local/share/pnpm/store/v11
  Virtual store is at:             ../../root/.local/share/pnpm/global/v11/128-18dd0e9ceff42da8-0/node_modules/.pnpm
.../global/v11/128-18dd0e9ceff42da8-0    | Progress: resolved 1, reused 0, downloaded 0, added 1, done
 
dependencies:
+ pnpm file:../../../../../../../tmp/tmp.qep6TjLgbi
 
Done in 304ms using pnpm v12.10.1
Appended new lines to /root/.bashrc
 
The following configuration changes were made:
export PNPM_HOME='/root/.local/share/pnpm'
case ":$PATH:" in
  ":$PNPM_HOME/bin:"*) ;;
  *) export PATH="$PNPM_HOME/bin:$PATH" ;;
esac
 
To start using pnpm, run:
source /root/.bashrc
 
To uninstall, delete /root/.local/share/pnpm and the lines pnpm setup added to the shell config file named above.
See https://pnpm.io/uninstall
$ echo $?
0
$ pnpm --version
bash: line 1: pnpm: command not found
$ echo $?
127
$ source ~/.bashrc; pnpm --version
12.10.1
$ echo $?
0

— 2026-10-10 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-10 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • pnpm 12.10.1

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. Corepack を有効化する(推奨)

Corepack を有効にすると pnpm が使える(Node 25 以降は npm install -g corepack で導入してから)(Installation(新しいタブで開く))。

corepack enable pnpm
pnpm --version

package.json に "packageManager": "pnpm@9.15.9" のように正確なバージョンを書いておくと、参加者全員が同じバージョンに揃う。
pnpm@9.x のような範囲指定は Corepack が Invalid package manager specification in package.json (pnpm@9.x); expected a semver version で拒否する。

2. npm でグローバルインストールする

Corepack を使わない場合は、npm で入れるのが手軽である。

npm install -g pnpm

3. スタンドアロンスクリプトで入れる

Node 非依存で入れる場合は公式スクリプトを使い、表示される PNPM_HOME を PATH に追加する。

curl -fsSL https://get.pnpm.io/install.sh | sh -
# 出力に従い PNPM_HOME を PATH へ追加し、シェルを開き直す
exec "$SHELL"

よくある原因

  1. そもそも pnpm を導入していない。
  2. Corepack を有効にしていない。
    Node 24 まで(14.19.0・16.9.0 以降の版)には Corepack が同梱されるが、既定では無効で corepack enable が要る。
    Node 25 以降は同梱されなくなったため、先に npm install -g corepack で導入する。
  3. PATH を通していない。
    スタンドアロンスクリプトで入れた場合、PNPM_HOME を PATH に追加しないと解決されない。
  4. シェルを読み込み直していない。
    インストール直後に同じシェルのまま叩いていて、更新後の PATH が読まれていない。