GoLand 2026.3 Help

実行 / デバッグ構成

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

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

  • 一時 — 一致する永続的な構成が存在しない場合に、main 関数またはテストを実行またはデバッグすると作成されます。

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

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

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

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

一時的な実行 / デバッグ構成を作成する

一時的な実行 / デバッグ構成を作成するには、ガターまたはコンテキストメニューからコードを実行します。

エディターから実行

プログラムにパラメーターを渡さず、開始前に特定のアクションが不要な場合は、エディターから直接実行できます。

  • main 関数の近くの ガターで をクリックし、 実行 を選択します。

  • スクリプトを実行するには、スクリプトをエディターで開くか、 プロジェクト ツールウィンドウで選択して、コンテキストメニューから <スクリプトファイル名> の実行 を選択します。

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

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

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

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

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

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

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

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

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

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

  4. 構成 タブで、次のオプションを設定できます。

  5. 起動前 セクションで、アプリケーションを起動する前に特定のアクションを実行するかどうかを定義します。例えば、実行前に 外部ツール または別の実行/デバッグ構成を起動します。

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

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

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

Go ビルド設定のフィールドのリスト

命名

説明

実行種類

アプリケーションのスコープを構築します。 ファイル スコープと パッケージ スコープは、テストとコンパイル / 実行構成で同様に機能します (カバーするスコープの点で)。

  • ディレクトリ: サブディレクトリを処理せずに、指定したディレクトリにパッケージとしてアプリケーションをビルドします。

    テスト構成の場合、GoLand は指定したディレクトリとそのすべてのサブディレクトリ内のすべてのテストを実行します。

  • ファイル: ファイル フィールドで指定されたファイルからアプリケーションを構築します。 複数のファイルパスを渡すには、区切り文字として垂直バー(| )を使用します。 この構成は、プログラムを最初からファイルから実行するときに自動的に選択されます。

  • パッケージ: すべての依存関係を持つ単一のパッケージをビルドします。 ビルドするパッケージへの完全なインポートパスを パッケージパス フィールド(たとえば、 github.com/gorilla/mux )に指定します。 ガターの アプリケーションを実行 アイコン (the Run button) を使用して main 関数を実行すると、この構成が自動的に選択されます。

パッケージパス

コンパイルするパッケージの完全なインポートパス (たとえば、 myServerApp)。 このフィールドは、 パッケージ 実行種類を選択した場合にのみ使用できます。

Ctrl+Space を押すと、利用可能なパッケージのリストが表示されます。

出力ディレクトリ

実行可能ファイルを出力するディレクトリへのパス。

リモートターゲット上にビルドする

非ローカル実行ターゲットを選択すると、このチェックボックスが表示されます。 デフォルトではオフになっています。

選択すると、ソースファイルをターゲットにコピーし、そこでビルドします。 選択すると、GoLand は 出力ディレクトリ フィールドを非表示にします。

オフにすると、ローカルでビルドし、実行可能ファイルをターゲットにコピーします。

選択した Go SDK が WSL にある場合、このチェックボックスがオフでも、GoLand は実行ターゲットでビルドします。 詳細については、 ターゲットで実行を参照してください。

ビルド後に実行する

ビルド後にアプリケーションを実行します。

出力コンソールでターミナルをエミュレートする

アプリケーションを実行し、ターミナルに表示されるとおりに 実行 ツールウィンドウに出力を表示します。

次から入力をリダイレクトする

入力を読み取るファイル。

作業ディレクトリ

ビルドされたアプリケーションに使用されるディレクトリ。 相対ファイルまたはディレクトリを作成するコードがある場合、それらはこのディレクトリに相対的です。

環境

アプリケーションの環境変数。

環境変数を編集するには、フィールドの最後にある 閲覧 ボタンをクリックします。 環境変数 ダイアログで、 追加 ボタンをクリックし、必要な環境変数を追加します。

Go ツール引数

Go ツールの引数(例: -o)。 また、このフィールドでは マクロも使用できます。

すべてのカスタムビルドタグを使用する

このチェックボックスを選択すると、 Go|ビルドタグ の下にある カスタムタグ フィールドのタグがビルドコマンドに追加されます。

Go ツール引数 に -tags がすでに含まれている場合、コマンドは代わりにそれらのタグを使用します。

プログラム引数

ビルドされたアプリケーションの引数。 また、このフィールドでは マクロも使用できます。

sudo で実行する

昇格された特権でアプリケーションを実行します。

モジュール

現在のモジュールの名前。

起動前

選択した実行 / デバッグ構成を起動する前に起動するタスクを追加します。 タスクを追加するには、 追加 ボタン Alt+Insert をクリックし、追加するツールを選択します。

プロジェクトファイルとして保存

このオプションを有効にすると、構成をプロジェクトファイルとして保存し、 VCS を通じてチームメンバーと共有できます。

Go テスト構成のフィールドのリスト

命名

説明

テストフレームワーク

使用するテストフレームワークを選択します。

  • gotest: 標準の Go テストを実行します。 go test の詳細については、 パッケージテストを参照してください。

  • gocheck: gocheck フレームワークでテストを実行します。

  • gobench: ベンチマークを実行します。 詳細については、 パッケージテスト: ベンチマークを参照してください。

  • -fuzz をテストしてみよう: ファズテストを実行します。 ファジングは、問題を見つけるためにランダムまたは予期しない入力をコードに送信します。 詳細については、 Go ファジングを参照してください。

    実行 を使用してファジングを開始します。 デバッグ アクションは、 -fuzz をテストしてみよう フレームワークでは使用できません。

テスト種類

テストを実行するスコープを選択します。

  • ディレクトリ: 選択したディレクトリとそのサブディレクトリ内のテストを実行します。 ディレクトリ フィールドでディレクトリを指定します。

    テストをデバッグするには、代わりに パッケージ を選択します。

  • パッケージ: パッケージ内のテストを実行します。 パッケージパス フィールドに、パッケージのインポートパスを入力します。例: example.com/myapp/calc。

  • ファイル: 選択したファイルからテストを実行します。 ファイル フィールドに、 | で区切ったファイルパスを入力します。例: /work/myapp/calc.go|/work/myapp/calc_test.go。 同じディレクトリからファイルを選択します。 選択したテストフレームワークに対応するファイルが少なくとも一つ必要です。

パターン

このフィールドは、 ディレクトリ スコープと パッケージ スコープで使用できます。 ファイル スコープでは、パターンが設定されていない場合、GoLand が選択したファイル内のテスト関数からパターンを生成します。

実行するテストを選択する正規表現を入力します。 サブテストを含むテストでは、 / で式を区切ります。 最初の式はテスト名に一致し、以降の各式は次のレベルのサブテスト名に一致します。

たとえば、 TestAdd の add_positive_and_negative サブテストを実行するには、 ^\QTestAdd\E$/^\Qadd_positive_and_negative\E$ を入力します。

作業ディレクトリ

ビルドされたアプリケーションに使用されるディレクトリ。 相対ファイルまたはディレクトリを作成するコードがある場合、それらはこのディレクトリに相対的です。

出力ディレクトリ

ファイル または パッケージ スコープを使用する場合の、コンパイル済みテスト実行可能ファイル用ディレクトリ。

リモートターゲット上にビルドする

非ローカル実行ターゲットを選択すると、このチェックボックスが表示されます。 デフォルトではオフになっています。

選択すると、ソースファイルをターゲットにコピーし、そこでビルドします。 選択すると、GoLand は 出力ディレクトリ フィールドを非表示にします。

オフにすると、ローカルでビルドし、実行可能ファイルをターゲットにコピーします。

選択した Go SDK が WSL にある場合、このチェックボックスがオフでも、GoLand は実行ターゲットでビルドします。 詳細については、 ターゲットで実行を参照してください。

次から入力をリダイレクトする

コンソールの代わりに標準入力として使用するファイルへのパス。

環境

: テストを実行するために必要な環境変数。

環境変数を編集するには、フィールドの最後にある 閲覧 ボタンをクリックします。 環境変数 ダイアログで、 追加 ボタンをクリックし、必要な環境変数を追加します。

Go ツール引数

Go ツールの引数(例: -tags)。

すべてのカスタムビルドタグを使用する

このチェックボックスを選択すると、 Go|ビルドタグ の下にある カスタムタグ フィールドのタグがビルドコマンドに追加されます。

Go ツール引数 に -tags がすでに含まれている場合、コマンドは代わりにそれらのタグを使用します。

Go ツール引数 とこのチェックボックスのどちらでも -tags が指定されていない場合、GoLand はテストファイル内の //go:build 制約と // +build 制約からタグを選択できます。 これは、 ファイル スコープと、GoLand が選択されたテスト関数を識別できる場合の パッケージ スコープに適用されます。

プログラム引数

テストの引数。

sudo で実行する

昇格された権限でテストを実行します。 このオプションは、オペレーティングシステムがプロセスの昇格をサポートしている場合に、ローカル構成で使用できます。

起動前: ツールウィンドウをアクティブにする

選択した実行 / デバッグ構成を起動する前に起動するタスクを追加します。 タスクを追加するには、 追加 ボタン Alt+Insert をクリックし、追加するツールを選択します。

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

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

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

  • ファイル監視の実行 :このオプションを選択すると、GoLand に現在アクティブなすべての 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 実行 / デバッグ構成設定を指定します。

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

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

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

  • Go コマンドを実行する: プログラムを実行する前に Go コマンドを実行することを選択します。 例: go generate を実行して、コンパイル前にソースコードを生成できます。 Go コマンドの編集タスク ダイアログでは、自動補完を使用できます。 自動補完は、次のコマンド generate、 vet、 test -i をサポートしています。 独自のコマンドを使用できます。

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

削除ボタン

Alt+Delete

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

編集

Enter

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

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

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

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

実行構成を起動する

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

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

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

  • Alt+Shift+F10 を押す。 開いたメニューで、起動したい実行構成をクリックします。

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

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

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

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

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

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

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

    /.idea/* !/.idea/runConfigurations

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2026 年 11 月 6 日