WebStorm 2026.1 Help

実行 / デバッグ構成

WebStorm は、実行 / デバッグ構成を使用して、コードの実行、デバッグ、テストを行います。 各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。

実行 / デバッグ 構成には 2 種類あります:

  • 一時的 — コンテキストメニューから 実行 <項目名> を選択するたびに作成されます。 コンテキストメニューを呼び出すには、オブジェクトまたは領域を右クリックします。

  • 永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。 永続的な構成は、削除するまでプロジェクトの一部として残ります。

コードを実行、デバッグ、テストする際、WebStorm は既存の永続的な実行 / デバッグ構成を使用するか、新しい一時構成を作成します。

永続的な構成のアイコンは不透明ですが、一時的な構成のアイコンは半透明です。 構成アイコン上の赤い十字は、構成設定にエラーがあることを示します。

一時構成の最大数は 5 です。 新しい構成が追加されると、古い構成は自動的に削除されます。 必要に応じて、 設定 | 詳細設定 | 実行/デバッグ | 一時構成の上限 でこの制限を増やすことができます。

永続的構成と一時的構成には異なるアイコンがあります

永続的な実行 / デバッグ構成を作成する

WebStorm では、永続的な実行 / デバッグ構成を作成するための次の方法を提供しています:

一時的な構成を永続的なものとして保存する

  • 実行 / デバッグ 構成スイッチャーで一時構成を選択し、 をクリックして、 構成を保存 を選択します。

    実行 / デバッグ構成セレクター: 構成の保存
  • または、実行 / デバッグ構成ダイアログで一時構成を選択し、ツールバーの 保存 をクリックします。

  • 実行構成の編集 ダイアログ(実行 | 実行構成の編集 )を開き、保存する一時構成を選択して、ツールバーの 構成を保存 をクリックします。

    一時的な実行構成を「構成の編集」に保存するダイアログ

WebStorm は、さまざまな言語、ツール、フレームワーク用の実行 / デバッグ構成 テンプレートを提供します。 使用可能なテンプレートのリストは、インストールされている プラグインと有効になっているプラグインによって異なります。

テンプレートから実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成 ダイアログで、ツールバーの をクリックするか、 Alt+Insert を押します。 リストには、実行 / デバッグ構成テンプレートが表示されます。

    目的のテンプレートを選択します。 選択するテンプレートがわからない場合は、特定のテンプレートの詳細について 実行 / デバッグ構成ダイアログ を参照してください。

    実行 / デバッグ構成の作成: 構成タイプを選択する
  3. 名前 フィールドに実行 / デバッグ構成名を指定します。 この名前は、リストやメニューで実行 / デバッグ構成を識別するために使用されます。

  4. 構成の複数のインスタンスを同時に実行できるようにする場合は、 複数のインスタンスを許可する を選択します。 このオプションが無効になっている場合、構成を再実行しようとすると、アクティブなセッションが終了します。

  5. 実行 / デバッグ構成パラメーターを構成します。 必須パラメーターとオプションのパラメーターのリストは、選択した実行 / デバッグ構成型によって異なる場合があります。

    一部のオプションのパラメーターは非表示になっています。 これらを表示して有効にするには、 オプションを変更 リンクをクリックします。

    選択したテンプレートの詳細については、 実行 / デバッグ構成リファレンスのそれぞれのセクションを参照してください。

  6. 起動前 セクションで、アプリケーションの起動前に特定のアクションを実行するかどうかを設定できます。たとえば、実行 / デバッグ構成の起動前にツールやスクリプトを実行することが可能です。

    特定の 起動前 アクティビティの詳細については、 起動前 を参照してください。

  7. 構成をすぐに実行することも、保存して後で実行することもできます。

    • 実行構成を後で使用するために保存するには、 OK をクリックします。

    • 構成をすぐに実行するには、「実行 」をクリックします。

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。

項目

ショートカット

説明

追加ボタン

Alt+Insert

このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します:

  • Web ブラウザーを起動: ブラウザーを起動するには、このオプションを選択します。 開いたダイアログで、ブラウザーの種類を選択し、開始 URL を指定します。 また、ブラウザーを JavaScript デバッガーで起動するかどうかも指定します。

  • 外部ツールの実行: 外部アプリケーションを実行することを選択します。 開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 WebStorm でまだ定義されていない場合は、定義を追加してください。 詳細については 外部ツール外部ツール を参照してください。

  • 別の構成を実行: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。 複数の構成を並行して実行する場合は、 複合実行 / デバッグ構成を使用してください。

  • File Watchers を実行 :このオプションを選択すると、WebStorm が現在アクティブなすべての File Watchers を適用します。

  • リモート外部ツールを実行: リモート SSH 外部ツールを追加します。

  • Grunt タスクを実行: Grunt タスクを実行するには、このオプションを選択してください。

    表示される Grunt タスク ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

    Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。

  • gulp タスクを実行: Gulp タスクを実行するには、このオプションを選択してください。

    表示される Gulp タスク ダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。

    Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。

  • npm スクリプトを実行: npm スクリプトを実行するには、このオプションを選択してください。

    開いた NPM スクリプト ダイアログで、 npm 実行 / デバッグ構成設定を指定します。

  • React Native Bundler の起動: 実行中またはデバッグセッションの一部としてバンドラーを自動的に実行するには、このオプションを選択します。 デフォルトでは、これは react-native start を介して行われます。

    アプリケーションが Expo(英語) を使用している場合は、 start npm タスクを介して開発サーバーを実行する必要があります。 これを行うには、 追加 をクリックし、 React Native の設定 ダイアログで npm スクリプト を選択し、リストから start を選択します。

  • TypeScript のコンパイル: 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。 表示される TypeScript のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

    • エラーの確認 チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。

    • エラーの確認 チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。

  • CoffeeScript ソースマップを生成 :このオプションを選択すると、 CoffeeScript ソースのソースマップを生成します。 表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。

  • リモートホストにファイルをアップロードする: このオプションを選択すると、 デフォルトのサーバーアクセス構成に従って、アプリケーションファイルが自動的に サーバーにアップロードされます。

  • データソースから切断: 実行 / デバッグ構成を実行する前にデータソースへの接続を中断する場合は、このオプションを選択します。

the Remove button

Alt+Delete

このアイコンをクリックして、選択したタスクをリストから削除します。

編集

Enter

選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。

このページを表示する

実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。

ツールウィンドウをアクティブにする

デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。

それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、構成が実行されている場合は、 Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

ツールウィンドウにフォーカス

実行 / デバッグ構成を開始したときに、 実行または デバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

実行構成を起動する

既存の実行構成は、次のいずれかの方法で起動できます。

  • 実行ウィジェットで実行構成がすでに選択されている場合は、その横にある をクリックするか、 Shift+F10 を押します。

    実行ウィジェットの近くにある「実行」ボタン
  • 別の実行構成を選択する場合は、「実行ウィジェット 」をクリックします。 開いたメニューで、起動したい実行構成の横にある「 」をクリックします。

    実行ウィジェットメニューの実行構成の近くにある「実行」ボタン
  • Alt+Shift+F10 を押す。 開いたメニューで、起動したい実行構成をクリックします。

実行 / デバッグ構成を共有する

実行 / デバッグ 構成を共有すると、チームメイトが同じ構成でアプリケーションを実行できたり、実行中のプロセスにリモートでアタッチできるようになります。

WebStorm では、実行 / デバッグ 構成をプロジェクトファイルとして保存し、VCS を通じて共有する仕組みを提供しています。 同じメカニズムは、構成をファイルとして他のユーザーに送信したり、実行 / デバッグ構成のローカルバックアップを作成したり、ファイルからインポートしたりする場合にも使用できます。

レガシーな .ipr ベースのプロジェクトは、個別の 実行 / デバッグ 構成をサポートしていません。 レガシープロジェクトでは、 .ipr ファイルを VCS に追加することによってのみ、一度にすべての構成を共有できます。

  1. 実行 | 実行構成の編集 に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。

  2. 共有したい 実行 / デバッグ 構成を選択し、 プロジェクトファイルとして保存 オプションを有効にして、構成ファイルの保存場所を指定します。

    WebStorm 2019.3 以前と互換性が必要でない限り、任意の場所を設定できます。 これらのバージョンとの互換性を保つには、推奨される場所にファイルを保存してください。

    プロジェクトファイルボックスとして保存
  3. (オプション) .idea ディレクトリが VCS 無視ファイルに追加されると、 .idea/runConfigurations サブフォルダーも無視されます。 プロジェクトで Git を使用する場合は、次のように .gitignore を変更することで、 .idea/runConfigurations を共有し、 .idea を無視したままにすることができます。

    /.idea/* !/.idea/runConfigurations

実行 / デバッグ構成テンプレート

すべての実行 / デバッグ構成はテンプレートに基づいており、テンプレートは起動ロジックを実装し、パラメーターのリストとそのデフォルト値を定義します。 使用可能なテンプレートのリストはインストール時に事前定義されており、 プラグインを介してのみ拡張できます。 ただし、各テンプレートのデフォルトのパラメーター値を編集して、新しい実行 / デバッグ構成のセットアップを容易にすることができます。

テンプレートのデフォルト値を構成する

  1. 実行 | 実行構成の編集 に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ 構成ダイアログの左側ペインで、 構成テンプレートを編集… をクリックします。

    実行 / デバッグ構成から実行 / デバッグ構成テンプレートを編集するダイアログ
  3. 開いた 実行/デバッグ構成テンプレート ダイアログで、構成タイプを選択します。

  4. 必要なデフォルトパラメーターを指定し、 OK をクリックしてテンプレートを保存します。

    テンプレートの実行 / デバッグ

または、メインメニューから ファイル | 新規プロジェクトのセットアップ | 実行構成テンプレート を選択するか、 Shift を 2 回押して、 Templates for New Projects の入力を開始します。

実行 / デバッグ構成テンプレートを作成する

開いたダイアログで、構成型を選択し、右側のペインで目的のパラメーターを指定します。

実行 / デバッグ構成フォルダー

同じタイプの 実行 / デバッグ 構成が多数ある場合は、アクセスを簡単にするためフォルダーでグループ化できます。

グループ化された実行構成

実行 / デバッグ構成用のフォルダーを作成する

  1. 実行 | 実行構成の編集 に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成 ダイアログで、構成タイプを選択し、ツールバーの the New Folder icon をクリックします。 選択したタイプの新しい空のフォルダーが作成されます。

    構成フォルダーの追加
  3. 右側のテキストフィールドにフォルダー名を指定するか、デフォルトの名前を受け入れます。

    設定フォルダーの名前を指定する
  4. 目的の 実行 / デバッグ 構成を選択し、ターゲットフォルダーに移動します。

  5. 変更を適用します。 フォルダーが空の場合、保存されません。

フォルダーが不要になった場合は、 Delete を削除できます。 このフォルダーにグループ化された 実行 / デバッグ 構成は、対応する 実行 / デバッグ 構成タイプのルートに移動されます。

サービスツールウィンドウで実行 / デバッグ構成

サービス ツールウィンドウで複数の実行 / デバッグ構成を管理できます。 例: 複数のアプリケーションを開始、一時停止、停止し、それらのステータスを追跡し、アプリケーション固有の詳細を調べることができます。

サービスウィンドウに実行 / デバッグ構成を追加する

  1. メインメニューから 表示 | ツールウィンドウ | サービス を選択するか、 Alt+8 を押します。

  2. サービス ツールウィンドウで、 サービスを追加してください をクリックし、 実行構成 を選択します。

    サービスツールウィンドウ: 実行構成を追加する
  3. リストから実行 / デバッグ構成タイプを選択し、このタイプのすべての構成をウィンドウに追加します。

    すでに選択したタイプの構成を作成している場合、WebStorm はそれらを専用ノードに表示する まだ選択したタイプの構成がない場合、IDE は 新しい構成を追加 ダイアログを開きます。そこで 新しい実行/デバッグ構成を作成できます

2026 年 6 月 8 日