IntelliJ IDEA 2025.2 ヘルプ

テストの実行

テストを実行する方法はいくつかあります。ファイルまたはフォルダーから実行する方法、実行ウィジェットを使用する方法、構造ツールウィンドウから実行する方法などがあります。この記事では、テストの実行全般について説明します。特定のビルドツールに関する情報をお探しの場合は、以下を参照してください。

ファイルまたはフォルダー内で直接テストを実行する

テストを開始する前に特定のアクションを必要とせず、コードカバレッジなどの追加オプションを構成したくない場合は、次のオプションを使用してテストを実行できます。

  • そのクラス内のすべてのテストを実行するには、テストクラスにキャレットを置きます。または、テストメソッドにキャレットを置き、Ctrl+Shift+F10 を押します。または、テストクラスまたはテストメソッドの横にある ガターアイコンをクリックし、リストから実行 '<test name>' を選択します。

    ガターアイコンは、テストの状態に応じて変化します。

    • ガターアイコンは、一連のテストを示します。

    • ガターアイコンは、新しいテストをマークします。

    • ガターアイコンは、成功したテストを示します。

    • ガターアイコンは、失敗したテストをマークします。

    Running a test using the gutter icon
  • フォルダー内のすべてのテストを実行するには、プロジェクトツールウィンドウでこのフォルダーを選択し、Ctrl+Shift+F10 を押すか、コンテキストメニューから「フォルダー」でテストを実行するを選択します。

実行ウィジェットを使用してテストを実行する

テストを実行すると、IntelliJ IDEA は一時的な実行構成を作成します。一時的な実行構成を保存したり、設定を変更したり、チームの他のメンバーと共有したりできます。詳細については、実行 / デバッグ構成を参照してください。

  1. 新しい実行構成を作成するか、一時的な構成を保存します。

  2. メインツールバーの実行ウィジェットを使用して、実行する構成を選択します。

  3. をクリックするか、Shift+F10 を押します。

    Running a run/debug configuration for tests

Structure からテストを実行する

構造ツールウィンドウでは、実行するクラス内の 1 つまたは複数のテストメソッドを選択できます。この場合、IDE はこれらのメソッドを含む一時的な実行構成も作成し、保存して編集できます。

  1. 構造ツールウィンドウで、1 つまたは複数のテストメソッドを右クリックし、 実行 'method name' (Ctrl+Shift+F10) を選択します。

    Run code from the tool window

    ツールウィンドウを使用すると、パターンを使用してテスト範囲が指定されている既存の実行構成 (JUnit および TestNG テスト用) にテストメソッドを追加できます。テストスイートを作成するために、複数の異なるクラスからメソッドを追加できます。

  2. 構造ツールウィンドウでメソッドを右クリックし、次を選択します。

    • パターンテストスコープを含む構成が 1 つしかない場合は一時スイートに追加: <構成名>

    • パターンテストスコープに複数の構成がある場合、JUnit パターンスイートに追加 (JUnit) / 一時スイートに追加 (TestNG)。この場合、ターゲット構成を選択できるポップアップが表示されます。

    Run code from the tool window

IntelliJ IDEA がテストの実行を終了すると、その実行構成のタブ上の実行ツールウィンドウに結果が表示されます。テスト結果の分析の詳細については、「テスト結果を調べる」を参照してください。

Tests shows in run configuration tab

右側のコンソールには、現在のテストセッションの出力が表示されます。テスト結果のリストの上にあるテスト結果ツールバーには、いくつかの便利なオプションがあります。

the test results toolbar

コミット後にテストを実行する

変更をプッシュする前に、変更によってコードが壊れないことを確認したい場合は、コミットチェックとしてテストを実行します。

テスト構成をセットアップする

  1. Alt+0 を押してコミットツールウィンドウを開き、コミットオプションを表示 the Settings button をクリックします。

  2. 高度なコミットチェック」メニューで、「テストの実行」オプションの横にある「構成の選択」をクリックし、実行する構成を選択します。これは、ビルドツールによって提供されるテスト構成 (gradle test など)、またはプロジェクトの単一のテストクラスにすることができます。

    Pre-commit checks menu

テスト構成をセットアップした後、コミットするたびに指定されたテストが実行されます。

テストを停止

実行構成のタブのテスト結果ツールバーで次のオプションを使用します。

  • the Stop button をクリックするか、Ctrl+F2 を押してプロセスを直ちに終了します。

    Stop running tests
  • the Exit button をクリックしてプロセスを正常に終了し、シャットダウンフックを実行できるようにします。

    Terminate running tests gracefully

テストの再実行

1 つのテストを再実行

  • 実行ツールウィンドウの実行構成のタブでテストを右クリックし、実行 'test name' を選択します。

    Rerun a single test

セッションですべてのテストを再実行する

  • テスト結果ツールバーの the Rerun button をクリックするか、Ctrl+F5 を押してセッション内のすべてのテストを再実行します。

    Rerun all session tests

失敗したテストの再実行

  • 失敗したテストのみを再実行するには、テスト結果ツールバーの the Rerun Failed Tests icon をクリックします。

    Rerun failed tests

    Shift を押したまま をクリックすると、失敗したテストを再度実行するか、デバッグするかを選択できます。

    前回のテスト実行中に無視されたテストや開始されなかったテストを失敗したテストと一緒にトリガーするように IDE を構成できます。テスト結果ツールバーで the Settings button をクリックし、再実行失敗に開始されていないテストを含めるオプションを有効にします。

テストを自動的に再実行する

IntelliJ IDEA では、自動テストのようなランナーを有効にすることができます。現在の実行構成のテストは、関連するソースコードを変更すると自動的に再起動します。

  1. 自動テストのようなランナーを有効にするには、テスト結果ツールバーで 自動的に再実行をクリックします。

    Rerun Automatically option
  2. さらに、エディターで自動テストのポップアップを有効にすることもできます。これは、自動テストのようなランナーがオンになっていることを示します。ツールバーの 詳細アイコンをクリックし、エディターで自動実行ステータスを表示するを有効にしてください。

    自動テストのようなランナーが有効になっている場合、エディターに自動テストオン ポップアップが表示されます。ポップアップで をクリックすると、テストの自動再実行が無効になります。

    Auto-test popup in editor

失敗したテストをデバッグする

テストが失敗する理由がわからない場合は、デバッグすることができます。

  1. エディターで、ブレークポイントを設定する行のガターをクリックします。

    プログラムを中断したい場所に応じて、使用できるブレークポイントにはさまざまなタイプがあります。詳細については、ブレークポイントを参照してください。

  2. 失敗したテストの横にある ガターアイコンを右クリックし、デバッグ 'test name' を選択します。

    テストはデバッグモードで再実行されます。その後、テストは一時停止され、現在の状態を確認できるようになります。

    テストをステップ実行して、その実行を詳細に分析できます。

    Debugging a test using the gutter icon
2025 年 3 月 25 日

関連ページ:

Maven でのテスト

Maven プロジェクトでは、デフォルトの IntelliJ IDEA テストランナーを使用して、他のプロジェクトと同じ方法でテストを作成および実行できます。簡単な JUnit テストを実行する Maven プロジェクトを開きます。エディターでテストクラスを作成または開き、ガターでクリックして実行します。結果は実行ツールウィンドウに表示されます。定期テストの作成または実行の詳細については、「テスト」セクションを参照してください。テストの実行を Maven に委譲できます。JUnit または Te...

Gradle でのテスト

Gradle プロジェクトでは、他のプロジェクトと同じ方法でテストを作成および実行できます。IntelliJ IDEA では、テストプロセスのデフォルトのテストランナーを変更したり、テストごとにテストランナーを構成することもできます。テストランナーを構成する Gradle ツールウィンドウで、をクリックして Gradle 設定ページを開きます。テストを使用して実行するリストで、選択した Gradle プロジェクトの次のテストランナーオプションのいずれかを選択します。Gradle: IntelliJ I...

コードカバレッジ

IntelliJ IDEA のコードカバレッジを使用すると、特定の実行中に実行されたコード行を分析できます。これにより、テストでカバーされたコードの割合を決定し、テストカバレッジが不十分な領域を特定できます。Java のコードカバレッジプラグインを有効にするこの機能は、デフォルトで IntelliJ IDEA にバンドルされ有効になっている Code Coverage for Java プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してくださ...

実行 / デバッグ構成

IntelliJ IDEA は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — 永続的な構成を持たないクラスを実行するたびに作成されます。これは、メソッドを持つクラスの実行を可能にする最低限のものを提供します。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成...

ファイル構造

IntelliJ IDEA を使用すると、構造ツールウィンドウおよび構造ポップアップでファイルの構造を表示および移動できます。プロジェクトがバージョン管理されている場合、構造ツールウィンドウと構造ポップアップに VCS ステータスの色が表示されます。これは、ファイルの変更を追跡できます。変更されたオブジェクトの名前は青色になり、新しく追加されたオブジェクトの名前は緑色でハイライトされます。構造のアイコンにマウスを合わせると、ツールチップにその項目に関する追加情報が表示されます。例: メソッドが静的...

実行 / デバッグ構成: JUnit

JUnit 実行 / デバッグ構成は、JUnit テストフレームワークに基づくユニットテストの実行方法を定義します。新しい JUnit 実行構成を作成するメインメニューで、に移動します。実行 / デバッグ構成ダイアログで、ツールバーのをクリックするか、を押します。リストには、実行 / デバッグ構成テンプレートが表示されます。JUnit を選択します。右側に、構成オプションが表示されます。名前実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。実行構成を実行す...