# コードカバレッジ

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> OS  : Linux / macOS / Windows
>
>
>
> プロジェクトフォーマット  : [CMake](quick-cmake-tutorial.html)
>
>
>
>
>
>
>
> スイートを管理:  `実行 | カバレッジレポートの管理`  `Ctrl+Alt+F6` (Windows), `⌘ ⌥ F6` (macOS), `⌘ ⌥ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ F6` (macOS System Shortcuts), `Ctrl+Alt+6` (XWin), `Ctrl+Alt+6` (GNOME), `Ctrl+Alt+6` (KDE), `Ctrl+Alt+F6` (Emacs), `Ctrl+Alt+F6` (Sublime Text), `⌘ ⌥ F6` (Sublime Text (macOS)), `⌘ ⌥ F6` (Xcode), `Ctrl+Alt+F6` (Visual Studio), `⌘ ⌥ F6` (Visual Studio (macOS)), `Ctrl+Alt+F6` (ReSharper), `⌘ ⌥ F6` (ReSharper (macOS)), `Ctrl+Alt+F6` (QtCreator), `⌘ ⌥ F6` (QtCreator (macOS)), `Ctrl+Alt+F6` (NetBeans), `Ctrl+Alt+F6` (Eclipse), `⌘ ⌥ F6` (Eclipse (macOS))
>
>
>
> カバレッジ設定:  `設定 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) | ビルド、実行、デプロイ | カバレッジ​`

CLion では、コードカバレッジ測定を使用して CMake アプリケーションとテストを実行できます。 コードカバレッジの結果は、実行中に実行されたコード行の割合と、特定の行がヒットした回数を提供します。

CLion は [llvm-cov](https://llvm.org/docs/CommandGuide/llvm-cov.html)／ [gcov](https://gcc.gnu.org/onlinedocs/gcc/Gcov.html#Gcov) の統合により、コードカバレッジデータを収集して表示します。 これらのツールには特別なカバレッジコンパイラーフラグが必要です。 [手動](#compiler-flags)で渡すか、CLion に [自動](#flags-automatically)で追加させることができます。

## カバレッジのある CMake アプリケーションまたはテストの実行

カバレッジで実行   アクションは、 [CMake アプリケーション](run-debug-configuration-application.html)およびテスト構成（ [Boost.Test](run-debug-configuration-boost-test.html)、 [Google Test](run-debug-configuration-google-test.html)、 [Catch](run-debug-configuration-catch.html)）で使用できます。

カバレッジで実行   は、設定スイッチャーの横のツールバーまたはガターメニューから呼び出すことができます。

![カバレッジで実行](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_configaction.png)

![カバレッジで実行](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_gutteraction.png)

カバレッジで実行   を呼び出したが、カバレッジファイル（  `.gcov`  または  `.profraw`  ）が見つからない場合、CLion はカバレッジフラグを追加することを提案します。

![取材通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_flags_notification.png)

修正して再実行   をクリックすると、CLion は次のことを行います。

1.  現在使用中のプロファイルと同じビルドタイプ、ツールチェーン、CMake オプションを持ち、さらにカバレッジ用コンパイラーオプションが追加された既存の [CMake プロファイル](cmake-profile.html) を検索します（ [カバレッジ用コンパイラーフラグ](#compiler-flags) を参照）。 見つかった場合は、CLion がそのプロファイルに切り替え、カバレッジ付きで構成を実行します。

2.  そのようなプロファイルが見つからない場合、CLion は新しいプロファイルを作成し、現在のプロファイルから   ビルドタイプ  、   ツールチェーン  、   CMake オプション   のパラメーターをコピーし、カバレッジフラグを CMake オプションの  `CMAKE_CXX_FLAGS`  と  `CMAKE_C_FLAGS`  として渡します。 その後、CLion はこの新しく作成したプロファイルに切り替え、カバレッジ付きで構成を実行します。

![カバレッジフラグを含む CMake プロファイルを自動的に追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_addedprofile.png)

## カバレッジコンパイラーフラグ

カバレッジフラグを手動で渡す場合は、コンパイラーとカバレッジツールに応じて、次のいずれかのオプションを使用できます。

* GCC `-fprofile-arcs -ftest-coverage` または `--coverage` この場合、 gcov ツールが使用されます。

* Clang / Clang-cl ここに 2 つのオプションがあります。 * GCC と同じフラグを使用して、 [llvm-cov gcov(英語)](https://llvm.org/docs/CommandGuide/llvm-cov.html#llvm-cov-gcov) で収集された gcov スタイルのカバレッジを取得します。 * `-fprofile-instr-generate -fcoverage-mapping` を使用して、 `llvm-profdata merge` コマンドと `llvm-cov export` コマンドのペアを使用する [Clang のインストルメンテーションベースのプロファイリング(英語)](https://llvm.org/docs/CommandGuide/llvm-profdata.html)を呼び出します。 > **Note:** > [Clang-cl](quick-tutorial-on-configuring-clion-on-windows.html#clang-cl) の場合、コードカバレッジは x86 アーキテクチャでのみ使用できます。 [Visual Studio ツールチェーン](quick-tutorial-on-configuring-clion-on-windows.html#MSVC)の アーキテクチャー フィールドで必ず選択してください。

フラグを指定するには、  `CMAKE_CXX_FLAGS`  変数（   C   プロジェクトの場合は  `CMAKE_C_FLAGS`  ）を [設定(英語)](https://cmake.org/cmake/help/latest/command/set.html)するか、 [add_compile_options(英語)](https://cmake.org/cmake/help/latest/command/add_compile_options.html) コマンドなどの他の方法を使用します。

> **Tip:**
> gcov  コンパイラーフラグを使用してプロジェクトをビルド中にリンカーエラーが発生した場合は、  `add_link_options`  または  `set(CMAKE_EXE_LINKER_FLAGS "")`  を介してリンカーに同じフラグを渡してみてください。

## カバレッジ結果

カバレッジデータの準備ができると、カバレッジツールウィンドウが自動的に開きます。 最初は、起動時にカバーされたフォルダーごとのファイルの割合が表示されます。 フォルダーをダブルクリックすると、   行カバレッジ​   列と   ブランチカバレッジ​   列が表示されます。

![カバレッジツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_resultstoolwindow.png)

* 行カバレッジ​ は、ファイルごとにカバーされた行数を示します。 コンパイラーと使用しているフラグによって、動作方法が次のように異なることに注意してください。 GCC/gcov（ `--coverage` フラグ）は正確なラインカバレッジを提供します。 1 行に複数のコードブロックがある場合、少なくとも一部のステートメントが実行されていれば、その行は完全にカバーされている（エディターで緑色でマークされている）と見なされます。 Clang/llvm-cov は、プログラムが `-fprofile-instr-generate` `-fcoverage-mapping` でコンパイルされている場合、ステートメントカバレッジを提供します。 行内のすべてのステートメントが実行されなかった場合、その行は部分的に覆われている（黄色）とマークされます。

* ブランチカバレッジ​ は、各制御構造のすべてのブランチを考慮に入れます。 これは、LLVM バージョン 12.0.0 以降、および GCC の任意のバージョンでサポートされます。 macOS では、AppleClang のバージョンは以前の LLVM バージョンと一致します ( [この表(英語)](https://en.wikipedia.org/wiki/Xcode#Xcode_7.0_-_12.x_(since_Free_On-Device_Development))を参照)。 AppleClang 12.0.x は、ブランチカバレッジをサポートしない LLVM 10.0.x に対応します。 これを回避するには、GCC に切り替えるか、カバレッジコンパイラーフラグを `--coverage` に変更します。 ![ブランチカバレッジのコンパイラーフラグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_flags_branchcoverage_gcc.png) GCC と gcov ツールは、ブランチカバレッジを計算するときに、コンパイラーが生成したブランチを考慮します。 これは、たとえば、例外処理を使用する場合に結果に影響を与える可能性があります。

任意のファイルで、ガターインジケーターを確認し、特定の行の横のそれをクリックして、ヒットした回数を確認できます。

![カバレッジラインヒット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_linehits.png)

完全に実行された行は緑色でマークされます。 黄色のマーカーは、部分的にしか実行されなかったことを意味します。

カバレッジのハイライトの色を変更するには、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックするか、  `設定 | エディター | カラースキームの切り替え | 一般`  に移動して   行カバレッジ​   ノードを展開します。

CLion は、プロジェクトビューにカバレッジ統計も表示します。

![プロジェクトビューのコードカバレッジ結果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_projectview.png)

## 複数の実行の結果をマージする

カバレッジ分析を再実行すると、CLion は、新しい結果を表示する方法を選択するよう求めます。

![複数のカバレッジスイートのマージ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_severalsuites.png)

アクティブなスイートに追加   – 以前に収集された統計に新しい結果が追加されます。

アクティブなスイートを置き換え   – すでに収集されているデータは上書きされます。

収集したカバレッジデータを適用しない   – 新しい結果は無視されます。

## カバレッジ設定

コードカバレッジ設定は  `設定 | ビルド、実行、デプロイ | カバレッジ`  に収集されます。

![コードカバレッジ設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_settings.png)

ツール   セクションでは、  gcov  /  llvm-cov /  llvm-profdata  へのカスタムパスを提供できます。 デフォルトでは、CLion は  `PATH`  環境変数からパスを取得します。

## トラブルシューティング

* 空のカバレッジレポートが表示される場合は、 コンパイラーのバージョンは gcov/llvm-cov のバージョンと一致する ツール（デフォルトまたはカスタム）を使用しているかどうかを確認してください。 ![コンパイラーとカバレッジツールの不一致通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_coverage_mismatch_notify.png) [コンパイラーを変更し](how-to-switch-compilers-in-clion.html)たり、 [Windows ツールチェーン](quick-tutorial-on-configuring-clion-on-windows.html)を切り替えたりするときは、このことを覚えておいてください。

