環境構築
npx: command not found
npxコマンドが見つからない
こんな症状
npxを実行したら「command not found」と出る。古いNode.jsを使っているときや、nvmでバージョンを切り替えた直後に起きやすいよ。
まず試す
Node.jsを最新LTSに更新し、ターミナルを再起動する。
env
$ node --version
# バージョンが出ない/古い → Node.js LTS をインストール
$ npx --version
# 出ればOKこれで直らなければ、下の「自分のケース」を確認。
🔍 自分のケースはどれ？
- ✓Node.jsをインストールしていない
→ 公式サイトからNode.js LTSをインストールする。npm・npxが一緒に入る。 - ✓nvmでバージョンを切り替えた直後
→ ターミナルを再起動する。nvm use --lts でLTSに切り替えてから確認する。 - ✓pnpm: command not found の場合
→ pnpmは別ツールなので個別に導入する。corepack enable pnpm（Node.js 16.13+）か npm install -g pnpm でインストールする。
なぜ起きる？
Node.jsが古いバージョンでnpxが含まれていない、またはPATHが通っていないよ。npxはnpm 5.2.0以降に付属するコマンドで、パッケージをインストールせずに直接実行できる便利なツールなんだ。古いNode.jsにはnpxが含まれていない。また、nvm（Node.jsバージョン管理ツール）でNode.jsを切り替えた後にシェルのPATHが更新されていない場合や、そもそもNode.jsをインストールしていない場合もあるよ。
✕ エラーが起きるコード
$ npx create-react-app my-app
# command not found: npx✓ 直したコード
$ nvm install --lts && nvm use --lts
$ npx --version
# バージョンが表示されれば使える✅ 直ったか確認
npx --version がバージョン番号を表示すればOK。
🆘 まだ直らないときは
which node と which npx でパスを確認する。会社や学校のPCで権限がない場合は、nvmなどユーザー領域にインストールできる方法を使う。
Q&Aで質問する →この解決法は役立ちましたか？
🔗 関連するエラー
- npm installが失敗する — パッケージのインストールでエラーが出る
- node_modules削除後にエラーが出る — node_modulesを削除したが再インストールしていない
- Permission denied — 権限が不足している
- error: pathspec '...' did not match any file(s) known to git — 指定したファイル・ブランチが見つからない
- error: pathspec did not match any files — 指定したファイルが見つからない
📖 この問題を学べるレッスン
📝 関連ブログ記事
- プログラミングのエラーメッセージの読み方 — エラーの読み方を基礎から解説
- VS Codeのインストール方法 — インストールと初期設定を図解で解説
- プログラミング初心者が最初にやるべきこと5選 — 目的を決めて環境構築から