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

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

## 始める前に

Procedure:

1. お使いのコンピューターに [Node.js(英語)](http://nodejs.org/) がインストールされていることを確認してください。

2. JavaScript と TypeScript 、  Angular と AngularJS 、  JavaScript デバッガー  の必須プラグインが   設定 | プラグイン   ページで有効化されていることを確認します。 詳細については、 [プラグイン管理](managing-plugins.html)を参照してください。

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

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 an Angular app in the development mode from package.json](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_mode_package_json.animated.gif)

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

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

![Angular CLI アプリを実行する: 開発サーバーの準備ができました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_server_ready.png)

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

Angular CLI を使用して CLion   新規プロジェクト   ウィザード [上記のとおり](angular.html#create_new_angular_app)で作成されたアプリケーションの場合、CLion は [npm](run-debug-configuration-npm.html) 構成をデフォルト名   Angular CLI サーバー   で生成します。 この構成は、開発サーバーを起動し、開発モードでアプリケーションを起動する  `ng serve`  コマンドを実行します。

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

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

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

![構成の編集を開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/angular_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/angular_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/angular_run_rc_browser_tab_select_browser.png)

Procedure: アプリケーションの実行

1. ツールバーの   実行   ウィジェットのリストから、   npm   タイプの実行構成を選択します。 これは、自動生成された   Angular CLI サーバー   構成、または [前述のよう](#angular_running_and_debugging_run_via_rc_create_rc)に自分で作成したカスタム構成のいずれかになります。

2. ![実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックします。

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

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

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

![Angular CLI アプリを実行する: 開発サーバーの準備ができました](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_run_dev_server_ready.png)

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

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

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

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

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

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

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

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

* 開発モードで実行されているアプリケーションにデバッガーを接続するための JavaScript デバッグ​ 構成。 > **Note:** > If you generated your application with Angular CLI, [as described above](angular.html#create_new_angular_app), CLion has already generated these two run/debug configurations.

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

または、   npm   と   JavaScript デバッグ​   の実行/デバッグ構成を、 [JavaScript Debug 実行/デバッグ構成でデバッグを開始する](#angular_debug_via_js_debug_rc)で説明されているように、個別に起動します。

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

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

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

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

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

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

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

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

![ブラウザー / ライブ編集タブ: ブラウザーを選択](https://resources.jetbrains.com/help/img/idea/2026.3/angular_run_rc_browser_tab_select_browser.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/angular_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) を   デバッグ   ツールウィンドウのツールバーで押します。

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

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

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

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

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

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

If you generated your application with Angular CLI, [as described above](angular.html#create_new_angular_app), CLion has already created a   JavaScript デバッグ​   run/debug configuration with the default name   アプリケーションのデバッグ機能   and the default URL  `http://localhost:4200` .   JavaScript デバッグ​   ノードのリストからこの実行 / デバッグ構成を選択します。

![生成された JavaScript デバッグ実行 / デバッグ構成を選択する](https://resources.jetbrains.com/help/img/idea/2026.3/angular_debug_select_js_debug_rc.png)

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

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

> **Note:**
> 自動生成された構成を使用している場合は、指定された URL アドレスが、アプリケーションが実際に実行されているアドレスであることを確認してください。

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/angular_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`  の開発モードで実行されている場合、特に Angular CLI を使用して生成された場合は、   > 実行   ツールウィンドウまたは組み込みの   ターミナルエミュレータ   から直接デバッグセッションを開始できます。

Procedure:

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

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

3. 実行   ツールウィンドウまたは   ターミナルエミュレータ   には、アプリケーションが実行されている URL が表示されます。 アプリケーションが @angular/cli で生成された場合、デフォルトの URL は  `http://localhost:4200/`  です。 `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 starts a debugging session with an automatically generated   Angular アプリケーション   configuration of the type [JavaScript Debug](run-debug-configuration-javascript-debug.html).

![Starting a debugging session from the Run tool window](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_start_debug_from_run_tw.animated.gif)

あるいは、リストから自動生成された   Angular アプリケーション   構成を選択し、リストの横にある   デバッグ   ボタン ![the Debug button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

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

![新しいターミナル: ブラウザーで Angular のデバッグを開始するボタン](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_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) を   デバッグ   ツールウィンドウのツールバーで押します。

### Node.js 17 以降のトラブルシューティング

Node.js バージョン 17 以降を使用している場合、デバッグセッション中にネットワーク接続の問題が発生し、デバッガーの接続やソースマップのロードで問題となることがあります。

回避策は、  `パッケージ.json​​`  の  `start`  スクリプトを次のように更新して、  `--host 127.0.0.1`  をサーバーに渡すことです。

```JSON
"start": "ng serve --host=127.0.0.1"

```

