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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

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

> **Note:**
> `create-react-app`  で作成されたアプリケーションのみ。

Procedure:

1. `パッケージ.json​​`  の  `start`  スクリプトの横にあるガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) をクリック、あるいは   ターミナルエミュレータ   `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) で  `npm run start`  コマンドを実行、または [npm ツールウィンドウ](npm-tool-window.html)（  `表示 | ツール Windows | npm` ）で  `start`  タスクを double-click してください。

![Run a React app in the development mode from package.json](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_run_dev_mode_package_json.animated.gif)

2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまでお待ちください。

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

![React アプリが実行中です](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_debug_cra_app_is_running.png)

> **Tip:**
> [Webpack ホットモジュール交換(英語)](https://webpack.github.io/docs/hot-module-replacement.html)のおかげで、開発サーバーが稼動しているときに、ソースファイルを変更して更新を保存するとすぐにアプリケーションが自動的に再ロードされます。

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

[上記のように](react.html#creating_react_app_with_generators)、CLion   新規プロジェクト   ウィザードで  `create-vite`  を使って作成したアプリケーションには、CLion がデフォルト名   npm start   の [npm](run-debug-configuration-npm.html) 構成を生成します。 この構成では、開発サーバーを起動し、アプリケーションを開発モードで開始する  `react-scripts start`  コマンドを実行します。

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

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

Procedure:

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

![構成の編集を開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/react_run_config_create.png)

開いた   実行構成の編集   ダイアログで、ツールバーの   追加   ボタン ( ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) をクリックし、リストから   npm   を選択します。

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

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

![npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_npm_rc.png)

3. オプション:

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

アプリケーションをデバッグする場合は、 [Google Chrome(英語)](http://www.google.com/chrome/) または別の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)を選択します。

![ブラウザー / ライブ編集タブ: ブラウザーを選択](https://resources.jetbrains.com/help/img/idea/2026.3/react_run_rc_browser_tab_select_browser.png)

#### アプリケーションの実行

Procedure:

1. ツールバーのリストから   npm start   run 構成を選択し、その横にある ![実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックします。

![実行 / デバッグ構成を介して開発モードで React アプリを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/react_run_dev_mode.png)

2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまでお待ちください。

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

![React アプリが実行中です](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_debug_cra_app_is_running.png)

あるいは、 [上記](#ws_react_start_app_in_dev_mode_enable_opening_browser)のように CLion で起動時にアプリケーションを開くよう有効化することもできます。

> **Note:**
> 開発サーバーが実行中は、ソースファイルを変更して更新を保存すると、アプリケーションは自動的に再読み込みされます。

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

> **Note:**
> React アプリケーションのデバッグは、 [Google Chrome(英語)](http://www.google.com/chrome/) およびその他の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)でのみサポートされています。

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

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

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

* [上記のよう](#react_running_and_debugging_run)に、開発モードでアプリケーションを起動するための npm 構成。

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

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

または、 [JavaScript Debug 実行 / デバッグ構成でデバッグを開始する](#react_debug_via_js_debug_rc)に記載のとおり、   npm   と   JavaScript デバッグ​   の実行 / デバッグ構成を別々に作成・起動してください。

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

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

1. コードに [ブレークポイントを設定](using-breakpoints.html)します。

2. [上記の説明に従って](#react_running_and_debugging_run_via_rc_create_rc)   npm   構成を作成します。

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

![自動生成された npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/react_run_dev_mode.png)

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

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

![npm 実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_npm_rc.png)

4. ブラウザー / Live Edit   タブで、   起動後   チェックボックスを選択し、リストから [Google Chrome(英語)](http://www.google.com/chrome/) または別の [Chromium ベースのブラウザー(英語)](https://www.chromium.org/)を選択し、   JavaScript デバッガーで   チェックボックスを選択して、アプリケーションを実行する URL を指定します。

![npm 設定、ブラウザータブ](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_npm_rc_browser_tab.png)

5. 実行   をクリックします。

構成を再実行するには、   実行   ウィジェットのリストから構成を選択し、その横にある ![実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックします。

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

![デバッグセッション](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_npm_rc_debugging_session.png)

6. 最初のブレークポイントに到達したら、 [デバッグツールウィンドウ](debug-tool-window.html)に切り替え、通常どおり続行します： [プログラムをステップ実行](stepping-through-the-program.html)、 [プログラムの実行を停止して再開](null)、 [中断時にそれを調べ](examining-suspended-program.html)、コールスタックや変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM を表示](viewing-actual-html-dom.html)などが可能です。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

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

Procedure:

1. コードに [ブレークポイントを設定](using-breakpoints.html)します。

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

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

![アプリケーションは開発モードで実行されています](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_app_running_in_dev_mode.png)

3. JavaScript デバッグ​   構成を作成します。 これを行うには、メインメニューの  `実行 | 実行構成の編集​`  に移動し、 ![追加アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、リストから   JavaScript デバッグ   を選択します。

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

![JavaScript デバッグ構成を作成する: URL を指定する](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_create_js_debug_rc.png)

5. デバッグ   をクリックします。

構成を再実行するには、   実行   ウィジェットのリストから構成を選択し、その横にある ![デバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

![実行ウィジェットから JavaScript デバッグ構成を実行する](https://resources.jetbrains.com/help/img/idea/2026.3/react_debug_rerun_js_debug_rc.png)

6. 最初のブレークポイントに到達したら、 [デバッグツールウィンドウ](debug-tool-window.html)に切り替え、通常どおり続行します： [プログラムをステップ実行](stepping-through-the-program.html)、 [プログラムの実行を停止して再開](null)、 [中断時にそれを調べ](examining-suspended-program.html)、コールスタックや変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM を表示](viewing-actual-html-dom.html)などが可能です。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

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

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

Procedure:

1. コードに [ブレークポイントを設定](using-breakpoints.html)します。

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

3. 実行   ツールウィンドウまたは   ターミナルエミュレータ   には、アプリケーションが実行されている URL が表示されます。 `Ctrl+Shift` (Windows), `Ctrl+Shift` (macOS), `Ctrl+Shift` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift` (macOS System Shortcuts), `Ctrl+Shift` (XWin), `Ctrl+Shift` (GNOME), `Ctrl+Shift` (KDE), `Ctrl+Shift` (Emacs), `Ctrl+Shift` (Sublime Text), `Ctrl+Shift` (Sublime Text (macOS)), `Ctrl+Shift` (Xcode), `Ctrl+Shift` (Visual Studio), `Ctrl+Shift` (Visual Studio (macOS)), `Ctrl+Shift` (ReSharper), `Ctrl+Shift` (ReSharper (macOS)), `Ctrl+Shift` (QtCreator), `Ctrl+Shift` (QtCreator (macOS)), `Ctrl+Shift` (NetBeans), `Ctrl+Shift` (Eclipse), `Ctrl+Shift` (Eclipse (macOS)) を押したまま、この URL リンクをクリックします。 CLion は自動生成された    構成で、タイプ [JavaScript Debug](run-debug-configuration-javascript-debug.html) のデバッグセッションを開始します。

![Start debugging a React app from the Run tool window](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_start_debugging_from_run_tool_window.animated.gif)

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

![新しいターミナル: ブラウザーでデバッグを開始ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_start_debugging_from_new_terminal_start_debugging_button.png)

デフォルトでは、ボタンは表示されていません。 表示するには、   設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）を開き、  `詳細設定`  に移動して、   JavaScript and TypeScript   領域の   ターミナルの localhost リンクに 'ブラウザでデバッグを開始' ボタンを表示する   チェックボックスを選択してください。

> **Note:**
> このボタンは、WSL の   新しいターミナル   では使用できません。

最初のブレークポイントに到達したら、 [デバッグツールウィンドウ](debug-tool-window.html)に切り替え、通常どおり続行します： [プログラムをステップ実行](stepping-through-the-program.html)、 [プログラムの実行を停止して再開](null)、 [中断時にそれを調べ](examining-suspended-program.html)、コールスタックや変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM を表示](viewing-actual-html-dom.html)などが可能です。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

## 既知の制限

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

