llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

CTest

CTest(英語) は、CMake の一部として配布されているテスト自動化ツールです。

CTest の実行 / デバッグ構成

When you open a project that uses CTest, CLion detects the tests and automatically creates a run/debug configuration for them. この構成は すべてのテスト と呼ばれ、 CTest アプリケーション テンプレートに基づいています。

実行構成の編集 ダイアログで、自動的に作成された構成を編集し、同じタイプの構成をさらに追加できます。

CTests 用に自動的に作成された構成

CTest 構成を作成する

  1. In the main menu, go to 実行 | 実行構成の編集​, click and select CTest アプリケーション from the list of templates:

    CTest アプリケーション構成の追加
  2. 構成名を入力し、設定を指定します。

    • 実行するテストリスト フィールドで、含めるテストを選択します。 利用可能なテストのリスト 内でスマート検索を使用すると、ナビゲーションが簡単になります。

      CTest アプリケーションで利用可能なテストのリスト

      CLion は、使用している ctest のバージョンが 3.15 未満の場合、またはプロジェクトでテストが検出されなかった場合に通知します。

      テスト検出が失敗する警告

      この場合、 設定 | ビルド、実行、デプロイ | ツールチェーン の CMake のバージョンを確認し、 CMakeLists.txt ファイルで CTest テストが有効になっていることを確認してください。

    • CTest 引数 フィールドでは、追加のフラグを指定できます。 例: テストでサポートされている場合は、 --parallel を指定してテストを並行して実行します。

    Other fields of the configuration settings are described on the reference page.

CTest テストを起動する

テストを実行またはデバッグするには、次のいずれかのオプションを使用します。

  • スイッチャーで構成を選択し、ツールバーアイコンのいずれかをクリックするか、対応するショートカットを使用します。

    構成スイッチャーとツールバー
  • CMakeLists.txt ファイルを開き、目的のテストに対応する add_test コマンドを見つけます。 その横にある左側のガターアイコンをクリックして、オプションのリストから選択します。

    テスト用のガターメニュー

    ガターアイコンを使用してテストを実行すると、CLion は 一時的な CTest アプリケーション構成を作成しますが、構成のリストではグレー表示されます。 保存するには、 実行構成の編集 ダイアログで選択し、 を押します:

    一時的な構成の保存

CTest テストのデバッグ

  • If you start a debug session for a CTest test, CLion will run the test itself under debug instead of launching the ctest child process.

    マルチテスト構成の場合、リストから単一のテストを選択するように求められます。

    デバッグ用のテストのリスト

動的解析

  • テストに動的分析ツールを使用して、実行時の問題を排除できます。 CLion integrates with Valgrind Memcheck, Google Sanitizers, CPU Profiler, and Code Coverage, providing them with visualized output and handy features to help you work with the results. 詳細については、対応する記事を参照してください。

    テスト用のガターメニューでのプロファイリング

結果を調べる

  • テストを実行すると、CLion は組み込みの テストランナーウィンドウに結果とプロセスを表示します。 このウィンドウには以下が含まれます。

    • これまでに実行されたテストの割合を示す 進捗バー

    • 実行中のすべてのテストのステータスと期間を含む ツリービュー

    • コンソール output ストリーム

    • 失敗した テストを再実行する、 をエクスポートする、 で自動的に保存された以前の結果を開く、特定のテストを簡単に見つけるために のアルファベット順に並べ替える、または の期間で並べ替えて、どのテストが他のテストよりも長く実行されたかを理解するオプションを備えた ツールバー

    • テストが宣言されている CMakeLists.txt ファイルに移動する ソースに移動 などのアクションを含むコンテキストメニュー。

    テストランナーウィンドウ

テストをスキップする

  • 特定の場合、CTest はテストの失敗を無視できます。 これを構成するには、 SKIP_RETURN_CODE(英語) または SKIP_REGULAR_EXPRESSION(英語) プロパティを設定します。 CLion will detect these properties and mark the tests as Skipped in the output tree:

    テストをスキップする
2026 年 11 月 6 日