できない.dev

npm install -g したコマンドが command not found で実行できない

グローバルインストール先の bin ディレクトリが PATH に入っていないのが典型原因。
npm prefix -g で実際のインストール先を確認し、PATH に追加するか nvm 経由の構成に揃えると解決する。

公開: 更新:

症状できない · exit 127
json --version
bash: line 1: json: command not found
解決後できた · exit 0
json --version
json 11.0.0
written by Trent Mick
https://github.com/trentm/json

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

要約

npm install -g some-cli は成功するのに some-cli の実行が command not found になる原因は、ほとんどの場合、グローバルインストール先(prefix)の bin ディレクトリが PATH に入っていないことである。
まず npm prefix -g でインストール先を確かめ、PATH と突き合わせれば最短で切り分けられる。

実行例

インストール自体は added 1 package で成功しているのに、続けて json --version を叩くと exit 127 の command not found になる。
npm prefix -g が指すディレクトリの bin/ には実体が置かれており、そこを PATH に足すと同じコマンドがそのまま通る。

$ npm install -g json
added 1 package in 451ms
$ echo $?
0
$ json --version
bash: line 1: json: command not found
$ echo $?
127
$ npm prefix -g
/tmp/tmp.5oPwpQmlSY/npm-global
$ ls /tmp/tmp.5oPwpQmlSY/npm-global/bin
json
$ export PATH="$(npm prefix -g)/bin:$PATH"
$ json --version
json 11.0.0
written by Trent Mick
https://github.com/trentm/json
$ echo $?
0
$ which json
/tmp/tmp.5oPwpQmlSY/npm-global/bin/json

— 2026-08-29 時点の出力

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

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

解決策

1. インストール先を確認して PATH に追加する

npm prefix -g
# 例: /home/user/.npm-global
 
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

返ってきたディレクトリの bin(Windows は prefix 直下)が PATH に入っているかを確認する。

2. nvm のバージョンを揃える

nvm current
npm install -g some-cli

npm 公式ドキュメント(新しいタブで開く)も nvm などのバージョンマネージャ利用を推奨している。
nvm 環境では PATH は自動で切り替わるため、「使うバージョンで入れる」ことだけ守ればよい。

3. シェルのキャッシュをクリアする

hash -r

PATH を直した直後は bash / zsh がコマンドの場所をキャッシュしたままのことがある。
新しいターミナルを開くのでもよい。

4. npx で代替する

npx some-cli --version

たまにしか使わないツールなら npx で都度実行すれば PATH の問題自体が起きない。

よくある原因

  1. bin ディレクトリが PATH に無い。
    Linux / macOS では $(npm prefix -g)/bin、Windows では prefix 直下に実行ファイルが置かれるが、そこが PATH に含まれていない。
  2. nvm で別のバージョンに切り替えている。
    nvm は Node のバージョンごとに独立したグローバル領域を持つため、nvm use で切り替えた先にはコマンドが存在しない。
  3. prefix を変えたあと PATH を更新していない。
    EACCES 対策で npm config set prefix ~/.npm-global と変更したのに、PATH への追記やシェル再起動をしていない。
  4. Windows で PATH の設定が漏れている。
    環境変数の編集ミスなどで、npm のグローバルディレクトリが PATH から消えている。