PhpStorm 2026.1 Help

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

始める前に

  1. Node.js をダウンロードしてインストールします。

  2. JavaScript と TypeScriptAngular と AngularJSJavaScript デバッガー の必要なプラグインが 設定 | プラグイン ページのタブ インストール済み で有効化されていることを確認してください。 詳細は、 プラグインの管理を参照してください。

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

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

    Run an Angular app in the development mode from package.json
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ってください。

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

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

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

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

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

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

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

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

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

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

    コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの 開始 スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 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 アプリを実行する: 開発サーバーの準備ができました

    または、 上記のように、PhpStorm を有効化して起動時にアプリケーションを開けるようにします。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    上記のように Angular CLI でアプリケーションを生成した場合、PhpStorm はデフォルト名 アプリケーションのデバッグ とデフォルト 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 リンクをクリックしてください。 PhpStorm は、自動生成された Angular アプリケーション 構成(タイプ JavaScript デバッグ )でデバッグセッションを開始します。

    Starting a debugging session from the Run tool window

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

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

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

最初のブレークポイント到達時に デバッグツールウィンドウへ切り替え、 ステップ実行一時停止・再開中断時の調査 、コールスタック・変数の確認、ウォッチ設定、変数評価、 HTML DOM の実体表示など普通通りに操作できます。

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

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

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

"start": "ng serve --host=127.0.0.1"
2026 年 5 月 22 日