react-scripts: command not foundの解決方法【2025年最新版】
エラーの概要・症状
react-scripts: command not foundというエラーメッセージは、Reactアプリケーションを開発する際に使用されるcreate-react-appのスクリプトが見つからないことを示しています。このエラーは、主に以下の状況で発生します。
- Reactアプリケーションを新規に作成した後、
npm startやnpm run buildを実行した際に表示される。 react-scriptsパッケージが正しくインストールされていない場合や、パスの設定が間違っている場合に発生することが多いです。
具体的な症状としては、コマンドラインやターミナルでコマンドを実行した際にエラーメッセージが表示され、アプリケーションの起動やビルドができず、開発作業が進まなくなります。これにより、作業がストップしてしまうという困りごとが生じます。
このエラーが発生する原因
このエラーが発生する主な原因は以下の通りです。
react-scriptsパッケージが未インストール:create-react-appを使用してプロジェクトを作成する際に、必要な依存関係がインストールされていないと、このエラーが発生します。特に、react-scriptsはアプリケーションのビルドや実行に必要なスクリプトを提供します。npmのパス設定が不正: システムの環境変数にnpmのパスが正しく設定されていない場合、コマンドが見つからずにこのエラーが表示されます。特に、npmのグローバルインストール先がパスに含まれていないと問題が発生します。
権限の問題: 特にLinuxやmacOS環境では、npmのインストール時に権限が不足している場合、必要なファイルにアクセスできず、結果として
react-scriptsが見つからないことがあります。特に、node_modulesディレクトリやnpmキャッシュの権限が問題となることがあります。依存関係の競合: プロジェクト内で複数のパッケージが異なるバージョンの
react-scriptsを要求している場合、競合が発生し、正しくインストールされないことがあります。
解決方法1（最も効果的）
手順1-1: `react-scripts`を再インストールする
まず、react-scriptsがインストールされているか確認します。プロジェクトのルートディレクトリで以下のコマンドを実行します。
コメント