IntelliJ IDEA 2026.1 Help

React アプリケーションの実行とデバッグ

React アプリケーションを実行する

  1. package.json start スクリプトの横にあるガターで the Run icon をクリックするか、 ターミナル Alt+F12npm run start コマンドを実行するか、 npm ツールウィンドウ表示 | ツールウィンドウ | npm )で start タスクをダブルクリックします。

    Run a React app in the development mode from package.json
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが create-react-app で生成された場合、デフォルトの URL は http://localhost:3000/ です。 アプリケーションを表示するには、このリンクをクリックしてください。

    React アプリが実行中です

実行 / デバッグ構成を介して React アプリケーションを実行する

上記のように、IntelliJ IDEA 新規プロジェクト ウィザードで create-vite を使用して作成されたアプリケーションの場合、IntelliJ IDEA はデフォルト名 npm startnpm 構成を生成します。 この構成では、開発サーバーを起動し、アプリケーションを開発モードで開始する react-scripts start コマンドを実行します。

それ以外の場合は、ホスト、ポートなどの実際の設定を手動で 実行 / デバッグ構成を作成するする必要があります。

npm 実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に移動します。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ

    開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから すでに npm を選択します。

  2. 開いた 実行 / デバッグ構成: npm ダイアログの 構成 タブで、使用する package.json のロケーション、Node.js ランタイム、およびパッケージマネージャーを指定します。

    コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの start スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

    npm 実行 / デバッグ構成
  3. オプション:

    ブラウザーでアプリケーションを開くには、構成を次のように更新します: ブラウザー / Live Edit タブで、 起動後 チェックボックスをオンにし、アプリケーションを開くブラウザーを選択して、アプリケーションが実行される URL アドレスを指定します。

    アプリケーションをデバッグする場合は、 Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。

    ブラウザー / ライブ編集タブ: ブラウザーを選択

アプリケーションの実行

  1. ツールバーのリストから npm start 実行構成を選択し、その横にある 実行 をクリックします。

    実行 / デバッグ構成を介して開発モードで React アプリを実行する
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションを表示するには、このリンクをクリックしてください。

    React アプリが実行中です

    または、 上記のように、 IntelliJ IDEA が起動時にアプリケーションを開くようにします。

React アプリケーションをデバッグする

デバッグセッションは、 実行 / デバッグ構成を起動するから開始することも、開発モードでアプリケーションが実行されている URL を表示する 実行ツールウィンドウから開始することもできます。

実行 / デバッグ構成を介してデバッグを開始する

React アプリケーションをデバッグするには、2 つの実行 / デバッグ構成が必要です。

  • 上記のように、開発モードでアプリケーションを起動するための すでに npm 構成。

  • 開発モードで実行されているアプリケーションにデバッガーを接続するための JavaScript デバッグ 構成。

npm 実行 / デバッグ構成を使用して React アプリケーションを実行およびデバッグするに従って、 すでに npm 構成内に JavaScript デバッグ 構成を作成して、一度に起動することができます。

または、 JavaScript デバッグ実行 / デバッグ構成でデバッグを開始するに従って、 すでに npmJavaScript デバッグ の実行/デバッグ構成を個別に作成して起動します。

単一の npm 実行 / デバッグ構成で React アプリケーションを実行およびデバッグする

単一の npm 実行 / デバッグ構成で React アプリケーションを実行およびデバッグする

  1. コードに ブレークポイントを設定します。

  2. 上記の説明に従ってすでに npm 構成を作成します。

    create-react-app を使用してアプリケーションを生成した場合、IntelliJ IDEA はデフォルト名 npm startすでに npm 構成をすでに作成しています。 構成は、 実行 ウィジェットおよび 実行 / デバッグ構成 ダイアログで利用できます。

    自動生成された npm 実行 / デバッグ構成
  3. 開いた 実行 / デバッグ構成: npm ダイアログの 構成 タブで、使用する package.json のロケーション、Node.js ランタイム、およびパッケージマネージャーを指定します。

    コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの start スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

    npm 実行 / デバッグ構成
  4. ブラウザー / Live Edit タブで、 起動後 チェックボックスを選択し、リストから Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択し、 JavaScript デバッガーを使用 チェックボックスを選択して、アプリケーションを実行する URL を指定します。

    npm 設定、ブラウザータブ
  5. 実行 をクリックします。

    構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある 実行 をクリックします。

    IntelliJ IDEA はアプリケーションを開発モードで実行し、同時にデバッグセッションを起動します。

    セッションのデバッグ
  6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行しプログラムの実行を停止して再開し中断時にそれを調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際のHTML DOMを表示します。

JavaScript デバッグ実行 / デバッグ構成でデバッグを開始する

  1. コードに ブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 この URL をコピーして、 後で JavaScript デバッグ構成で指定します

    アプリケーションは開発モードで実行されています
  3. JavaScript デバッグ 構成を作成します。 これを行うには、メインメニューの 実行 | 実行構成の編集 に移動し、 追加アイコン をクリックして、リストから JavaScript デバッグ を選択します。

  4. 開いた 実行 / デバッグ構成: JavaScript デバッグ ダイアログで、構成の名前と、開発モードでアプリケーションが実行されている URL アドレスを指定します。 この URL は、 上記のように、 実行 ツールウィンドウまたは ターミナル にコピーできます。

    JavaScript デバッグ構成を作成する: URL を指定する
  5. デバッグ をクリックします。

    構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある デバッグ をクリックします。

    実行ウィジェットから JavaScript デバッグ構成を実行する
  6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行しプログラムの実行を停止して再開し中断時にそれを調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際のHTML DOMを表示します。

実行ツールウィンドウまたは組み込みのターミナルからデバッグを開始する

アプリケーションが localhost の開発モードで実行されている場合、特に create-react-app で生成された場合は、 実行 ツールウィンドウまたは組み込みの ターミナル から直接デバッグセッションを開始できます。

  1. コードに ブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

  3. 実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 Ctrl+Shift を押したまま、この URL リンクをクリックします。 IntelliJ IDEA は、タイプ JavaScript デバッグの自動生成された 構成でデバッグセッションを開始します。

    Start debugging a React app from the Run tool window

    新しいターミナルから開発モードでアプリケーションを起動した場合は、リンクの横にある ブラウザーでデバッグを開始する ボタンをクリックするだけです。

    新しいターミナル: ブラウザーでデバッグを開始ボタン

最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行しプログラムの実行を停止して再開し中断時にそれを調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際のHTML DOMを表示します。

既知の制限

デバッグセッション中にアプリケーションを初めて開くと、ページの読み込み時に実行されるコード内のブレークポイントの一部にヒットしない場合があります。 その理由は、元のソースコードのブレークポイントで停止するには、IntelliJ IDEA がブラウザーからソースマップを取得する必要があるためです。 ただし、ブラウザーがこれらのソースマップを渡すことができるのは、ページが少なくとも 1 回完全にロードされた後でのみです。 回避策として、ブラウザーでページを自分で再ロードします。

2026 年 3 月 30 日