実行 / デバッグ構成

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

実行 / デバッグ構成には 2 つのタイプがあります：

一時的 — テスト、テストスイート、フィクスチャ、 main() エントリを実行 / デバッグするたびに作成され、ガターアイコン / を使用します。
永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するまでプロジェクトの一部として残ります。

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

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

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

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

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

一時的な実行 / デバッグ構成を永続的な構成として保存します。
テンプレートから作成または既存の構成をコピーします。

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

実行 / デバッグ構成スイッチャーで一時構成を選択し、をクリックして構成の保存を選択します。
または、実行 / デバッグ構成ダイアログで一時構成を選択し、ツールバーのをクリックします。

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

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

実行 | 実行構成の編集に進みます。または、 Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成ダイアログで、ツールバーのをクリックするか、 Alt+Insert を押します。リストには、実行 / デバッグ構成テンプレートが表示されます。
命名方法名フィールドに実行 / デバッグ構成名を指定します。この名前は、リストやメニューで実行 / デバッグ構成を識別するために使用されます。
構成の複数のインスタンスを同時に実行できるようにする場合は、複数のインスタンスを許可するを選択します。このオプションが無効になっている場合、構成を再実行しようとすると、アクティブなセッションが終了します。
選択したテンプレートに応じて、構成設定を入力します。例: CMake アプリケーション、カスタムビルドアプリケーション、 Gradle/Gradle ネイティブアプリケーション
起動前セクションで、アプリケーションを起動する前に特定のアクションを実行するかどうかを設定します。たとえば、実行前に外部ツールや別のビルド構成を起動することができます。ビルドステージをスキップするには、ビルドを起動前リストから削除します。
構成をすぐに実行することも、保存して後で実行することもできます。
- 実行構成を後で使用するために保存するには、 OK をクリックします。
- 構成をすぐに実行するには、「実行」をクリックします。

起動前

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

項目	ショートカット	説明
	`Alt+Insert`	このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します：外部ツールの実行: 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 CLion でまだ定義されていない場合は、定義を追加してください。詳細については、外部ツールおよび外部ツールを参照してください。別の構成を実行: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。ファイル監視の実行：このオプションを選択すると、CLion ですべての現在アクティブな File Watchersが適用されます。 Grunt タスクの実行: Grunt タスクを実行するには、このオプションを選択してください。表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。 gulp タスクの実行: Gulp タスクを実行するには、このオプションを選択してください。表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。 npm スクリプトを実行する。: npm スクリプトを実行するには、このオプションを選択してください。開いた NPM スクリプトダイアログで、 npm 実行 / デバッグ構成設定を指定します。 TypeScript のコンパイル: 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。 CoffeeScript ソースマップの生成：このオプションを選択すると、 CoffeeScriptソースのソースマップが生成されます。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。
	`Alt+Delete`	このアイコンをクリックして、選択したタスクをリストから削除します。
	`Enter`	選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
	`Alt+Up` `Alt+Down`	これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する		実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする		デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、設定の実行中は、 `Alt+4` または `Alt+5` を押すことで、対応するツールウィンドウを自分で開くことができます。
ツールウィンドウにフォーカス		実行 / デバッグ構成を開始したときに、実行またはデバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

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

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

実行 | 実行構成の編集に進みます。または、 Alt+Shift+F10 を押してから 0 を押します。
共有したい実行 / デバッグ構成を選択し、プロジェクトファイルとして保存する。オプションを有効化して、構成ファイルの保存場所を指定します。
CLion 2019.3 以前との互換性が不要であれば、任意の場所を指定できます。これらのバージョンとの互換性を保つには、推奨される場所にファイルを保存してください。
(オプション) .idea ディレクトリが VCS 無視ファイルに追加されると、 .idea/runConfigurations サブフォルダーも無視されます。プロジェクトで Git を使用する場合は、次のように .gitignore を変更することで、 .idea/runConfigurations を共有し、 .idea を無視したままにすることができます。
/.idea/* !/.idea/runConfigurations

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

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

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

実行 | 実行構成の編集に進みます。または、 Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成ダイアログの左側のペインで、構成テンプレートの編集… をクリックします。
開いた実行 / デバッグ構成テンプレートダイアログで、構成タイプを選択します。
必要なデフォルトパラメーターを指定し、 OK をクリックしてテンプレートを保存します。

環境変数とプログラム引数

プログラム引数と環境変数を適切な実行 / デバッグ構成に追加することで、アプリの実行時の動作に影響を与えることができます。

実行 | 実行構成の編集に進みます。または、 Alt+Shift+F10 を押してから 0 を押します。
開いた実行 / デバッグ構成ダイアログで、引数を渡す構成を選択し、環境変数を追加します。
プログラム引数フィールドに引数を入力します。引数はスペースまたは改行で区切る必要があります。
「」をクリックしてテキストフィールドを展開すると、引数をリストとして表示および編集できます。
「環境変数」フィールドに、変数名と値「<name>=<value> 」を入力します。複数の変数を追加する場合は、セミコロンで区切る必要があります。
または、をクリックして、変数名と値をユーザー環境変数リストに追加します。
開いたダイアログには、使用可能なシステム環境変数のリストも表示されます。選択した構成にシステム環境変数を使用しない場合は、システム環境変数チェックボックスをオフにします。
親の環境変数を含む既存の変数は、 $VAR$ 構文を使って参照できます。このような参照は大文字と小文字を区別します。例えば、Linux/macOS では PATH=xxx:$PATH$ 、Windows では Path=xxx;$Path$ です。既存の変数の参照は、リモートツールチェーン（CPP-15693 ）では現在利用できません。
CMake 環境も参照してください。
ファイルから変数をロードするフィールドに、CLion が環境を構成するスクリプトを指定します。このオプションは、 CMake、 Makefile、 Gradle ネイティブ、カスタムビルド、テスト構成（Boost.Test、 Catch、 Google Test、 Doctest、 CTest ）で使用できます。
スクリプトで変数を設定するには、次の構文を使用します。
set VAR=value
export VAR=value
スクリプトによって作成された環境は、対応する構成の 1 回の起動にのみ適用され、カスタム値よりも優先されることに注意してください。
指定されたスクリプトは、すべての起動前ステップの後に実行されます。