Go テスト

作成: 実行 | 実行構成の編集 | | Go テスト

Go テスト構成を使用すると、Go テストを実行およびデバッグできます。テストの実行の詳細については、次のトピックを参照してください。

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` をクリックし、追加するツールを選択します。

共通設定

実行構成を編集する際（ただし実行構成テンプレートは除く）、次のオプションを指定できます：

項目	説明
命名	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
複数のインスタンスを許可する	この実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、GoLand は実行中のインスタンスを停止して別のものを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。
プロジェクトファイルとして保存	実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。デフォルトでは無効になっており、GoLand は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

命名

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、GoLand は実行中のインスタンスを停止して別のものを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

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

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、GoLand は実行構成設定を .idea/workspace.xml に保存します。

起動前

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

項目	ショートカット	説明
	`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` を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。
ツールウィンドウにフォーカス		実行 / デバッグ構成を開始したときに、実行またはデバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

ログ

次のオプションは、この構成の実行のログ記録に関連しています。詳細については、ログオプションの設定を参照してください。

項目	説明
コンソールに表示するログファイルの指定	アプリケーションの実行中に表示するログファイルを指定します。をクリックして新しいログを追加します。ログファイルエイリアスの編集ダイアログで、次のように構成します。エイリアス: ログが表示されるタブの名前。ログファイルのロケーション: ログファイルまたは Ant パターン(英語)へのパスを指定します。ローリングログの複数のファイルがパターンに一致する場合、GoLand は最新のファイルを表示します。パターンでカバーできるすべてのファイルを表示する。: パターンに一致するすべてのログを表示します。テーブル内のログについて、次のオプションを構成できます：アクティブ: 指定したログファイルを表示します。内容のスキップ: 以前の実行からの古いログメッセージを表示しません。
コンソール出力をファイルに保存する	コンソール出力を指定の場所に保存します。パスを手動で入力するか、参照ボタンをクリックして表示されるダイアログで目的の場所を指定します。
メッセージが標準出力に出力されたときにコンソールを表示する	アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。
メッセージが標準エラーに出力されたときにコンソールを表示する	アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。

2026 年 11 月 6 日