GoLand 2026.1 Help

実行 / デバッグ構成

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

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

  • 一時的 — 関数またはテストを実行またはデバッグするたびに作成されます。

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

コードを実行、デバッグ、テストするたびに、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 )に指定します。 この構成は、 main 機能を実行するか、ガターの アプリケーションを実行 アイコン(the Run button )を使用して別のテストを実行すると、自動的に選択されます。

パッケージパス

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

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

パッケージパスフィールドの自動補完

出力ディレクトリ

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

ビルド後に実行する

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

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

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

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

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

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

作業ディレクトリ

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

環境

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

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

環境変数を追加する

Go ツール引数

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

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

ビルド中に適用されるすべてのタグ。 タグは、 Go ビルドタグCtrl+Alt+S 設定にリストされています。

プログラム引数

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

sudo で実行する

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

モジュール

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

起動前

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

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

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

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

命名

説明

テストフレームワーク

テストの実行に使用するパッケージを選択します。

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

  • gocheck: go check の拡張機能を使用し、より複雑なテストを実行します。 go check の詳細については、 「go check 」(英語)を参照してください。

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

  • -fuzz をテストしてみよう: 大量のランダムまたは半ランダムデータを生成して Go プログラムに入力することを含む自動テスト手法を使用します。 ファジングの目的は、プログラムのコードを調査し、従来のテスト方法では明らかでなかった潜在的なバグ、脆弱性、予期せぬ動作を明らかにすることです。 gobench の詳細については、 Go Fuzzingを参照してください。

テスト用パッケージ

テスト種類

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

  • ディレクトリ: 指定されたディレクトリですべてのテストを実行します。 ディレクトリ フィールドで、アプリケーションファイルとテストファイルを含むディレクトリへのパスを指定します(たとえば、 applicationFolder/ main.go および main_test.go )。

  • パッケージ: パッケージに属するすべてのテストを実行します。 パッケージパス フィールドで、実行するテストを含むパッケージへのパスを選択します(たとえば、 github.com/rcrowley/go-metrics)。

    パッケージテストを有効にするには、 Ctrl+Alt+S を押して設定を開き、 Go Go モジュール に移動して、 Go モジュールの統合を有効にする チェックボックスを選択します。

  • ファイル: テストファイルからすべてのテストを実行します。 ファイル フィールドに、テストファイルへのパスを入力します。

    ファイル フィールドに他のパスが含まれていないことを確認してください。

パターン

実行するテストを定義する正規表現を入力します。 GoLand は、指定された正規表現に一致するテスト、例、ファズテストのみを実行します。 テストの場合、式は括弧で囲まれていないスラッシュ (/) で区切られ、一連の正規表現になります。 テストの識別子の各セグメントは、シーケンスの対応する部分と一致する必要があります。

たとえば、 TestAdd テーブルテスト内で add_positive_and_negative という名前の特定のテストを実行する場合、正規表現は ^\QTestAdd\E$/^\Qadd_positive_and_negative\E$ になります。

label.scope.pattern

作業ディレクトリ

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

出力ディレクトリ

テスト結果があればそれを保存するディレクトリ。

ビルド後に実行する

ビルド後にテストを実行します。

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

コンソールの代わりにプログラム入力を受け取るファイルへのパス。

作業ディレクトリ

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

環境

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

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

環境変数を追加する

Go ツール引数

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

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

ビルド中に適用されるすべてのタグ。 タグは、 Go ビルドタグCtrl+Alt+S 設定にリストされています。

プログラム引数

テストの引数。

sudo で実行する

テストに 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 コマンドの編集タスク ダイアログでは、自動補完を使用できます。 自動補完は、次のコマンド 生成vettest -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 年 5 月 22 日