GoLand 2024.1 ヘルプ

実行 / デバッグ構成

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

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

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

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

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

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

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

Permanent and temporary configurations have different icons

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

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

エディターから実行

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

  • クラス宣言の近くのガターで をクリックし、実行を選択します。

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

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

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

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

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

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

    saving a temporary configuration

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 を押すと、利用可能なパッケージのリストが表示されます。

Autocompletion for the Package path field

出力ディレクトリ

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

ビルド後に実行する

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

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

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

作業ディレクトリ

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

環境

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

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

Add an environment variable

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 の詳細については、「ファジングに移動(英語)」を参照してください。

Packages for testing

テスト種類

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

  • ディレクトリ : 指定されたディレクトリですべてのテストを実行します。ディレクトリフィールドで、アプリケーションファイルとテストファイルを含むディレクトリへのパスを指定します(たとえば、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

作業ディレクトリ

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

出力ディレクトリ

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

ビルド後に実行する

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

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

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

作業ディレクトリ

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

環境

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

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

Add an environment variable

Go ツール引数

go ツールの引数(たとえば、-tags)。

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

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

プログラム引数

テストの引数。

sudo で実行する

テストに sudo 権限を付与します。

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

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

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

チームで作業している場合は、実行 / デバッグ構成を共有して、チームメイトが同じ構成を使用してアプリケーションを実行したり、実行中のプロセスにリモートで接続したりできるようにすることができます。

これらの目的のために、GoLand は、実行 / デバッグ構成をプロジェクトファイルとして保存し、VCS を通じて共有するためのメカニズムを提供します。同じメカニズムは、構成をファイルとして他の人に送信する場合にも使用できます。これにより、実行 / デバッグ構成が洗練されることがあり、手動で同期を維持するのは面倒でエラーが発生しやすくなるため、多くの時間を節約できます。

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

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

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

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

    /.idea/* !/.idea/runConfigurations

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

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

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

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

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

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

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

    Changing Run/debug templates

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

同じ種類の実行 / デバッグ構成が多数ある場合、フォルダーにグループ化すると、視覚的に区別しやすくなります。

グループ化すると、実行 / デバッグ構成が対応するフォルダーのリストに表示されます。

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

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

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

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

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

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

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

関連ページ:

プラグイン

プラグインは GoLand のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケットプ...

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成して、GoLand から実行します。例: ワークフローでは、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサーまたはポストプロセッサー、データベースユーティリティなどの実行が必要になる場合があります。外部ツールとして構成することにより、GoLand は専用のアクションを提供します。これは、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の実行構成を起動するときに実行...

バージョン管理

Go 言語開発環境 GoLand の使い方や高等テクニック満載の JetBrains 日本語公式ヘルプ。最新の英語版ヘルプ内容が随時反映されます。

テストの実行

ファイルまたはフォルダー内で直接テストを実行するテストを開始する前に特定のアクションが必要なく、追加のオプションを構成したくない場合は、次のオプションを使用してテストを実行できます。テストファイル内のすべてのテストを実行するには、キャレットをテストファイルまたはテストメソッドに置き、を押します。または、テストメソッドの横にあるガターアイコンをクリックし、リストから実行 '<test name>' を選択します。ガターアイコンは、テストの状態に応じて変化します。ガターアイコンは、一連の...

実行

プロジェクトに GOROOT セットアップがある場合は、GoLand からアプリケーションを直接実行できます。簡単な方法:エディターから実行プログラムにパラメーターを渡さず、プログラムを開始する前に特定のアクションを実行する必要がない場合は、エディターから直接実行できます。クラス宣言の近くのガターでクリックし、実行を選択します。スクリプトを実行するには、スクリプトをエディターで開くか、プロジェクトツールウィンドウで選択して、コンテキストメニューから実行 <script file name...