WebStorm 2026.1 Help

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

始める前に

  1. コンピューターに Node.js(英語) があることを確認してください。

  2. Angular と AngularJS および JavaScript デバッガー の必須プラグインが、 設定 | プラグイン ページのタブ インストール済み で有効になっていることを確認してください。 詳細については、 プラグインの管理を参照してください。

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

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

    Run an Angular app in the development mode from package.json
  2. アプリケーションのコンパイルと開発サーバーの準備が完了するまでお待ちください。

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

    Angular CLI アプリを実行する: 開発サーバーの準備ができました

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

Angular CLI で WebStorm 新規プロジェクト ウィザードを使ってアプリケーションを作成した場合、 上記のように 、WebStorm はデフォルト名 Angular CLI サーバーnpm 構成を生成します。 この構成は、開発サーバーを起動し、開発モードでアプリケーションを起動する ng serve コマンドを実行します。

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

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

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

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

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

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

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

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

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

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

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

アプリケーションの実行

  1. ツールバーの 実行 ウィジェットのリストから、 npm タイプの実行構成を選択します。 これは、自動生成された Angular CLI サーバー 構成、または 上記のように自分で作成したカスタム構成にすることができます。

  2. 実行 をクリックしてください。

    実行 / デバッグ構成を介して開発モードで Angular アプリを実行する
  3. アプリケーションのコンパイルと開発サーバーの準備が完了するまでお待ちください。

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

    Angular CLI アプリを実行する: 開発サーバーの準備ができました

    または、 上記のように、WebStorm で起動時にアプリケーションを開くよう有効にできます。

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

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

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

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

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

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

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

または、 npm および JavaScript デバッグ 実行/デバッグ構成を、 JavaScript デバッグ実行/デバッグ構成でデバッグを開始に従い、個別に起動します。

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

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

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

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

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

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

    npm 設定、ブラウザータブ
  5. 実行 をクリックしてください。

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

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

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

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

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

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

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

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

    上記のように Angular CLI を使用してアプリケーションを生成した場合、WebStorm は、デフォルト名 アプリケーションのデバッグ​​/ とデフォルト URL http://localhost:4200 を持つ JavaScript デバッグ 実行 / デバッグ構成をすでに作成しています。 JavaScript デバッグ ノードのリストからこの実行 / デバッグ構成を選択します。

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

    JavaScript デバッグ構成を作成する: URL を指定する
  5. デバッグ をクリックしてください。

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

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

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

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

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

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

  3. 実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが @angular/cli で生成された場合、デフォルトの URL は http://localhost:4200/ です。 Ctrl+Shift を押したまま、この URL リンクをクリックします。 WebStorm は、タイプ JavaScript デバッグ の自動生成された Angular アプリケーション 構成でデバッグセッションを開始します。

    Starting a debugging session from the Run tool window

    あるいは、リストから自動生成された Angular アプリケーション 構成を選択し、リストの横にある デバッグ ボタン 「デバッグ」ボタン をクリックします。

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

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

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

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

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

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

"start": "ng serve --host=127.0.0.1"
2026 年 6 月 8 日