用 gcov 做 C++ 代码覆盖率测试，核心是编译时加 -fprofile-arcs -ftest-coverage，运行程序后生成 .gcda 文件，再用 gcov 工具分析源码覆盖情况。它不依赖单元测试框架本身，但必须让被测代码实际执行——所以通常配合单元测试（如 Google Test、Catch2）一起用。

编译阶段：开启覆盖率采集

在编译 C++ 源文件和测试可执行文件时，需添加两个关键选项：

• -fprofile-arcs：插入探针，记录每条边（分支）的执行次数
• -ftest-coverage：生成 .gcno 文件（包含源码结构信息），供后续 gcov 解析

例如使用 g++ 编译：

注意：所有参与覆盖率统计的源文件都必须加这两个选项，包括被测模块和测试代码；同时建议保留 -g 以便关联源码行号。

立即学习“C++免费学习笔记（深入）”；

运行阶段：触发 .gcda 文件生成

执行一次测试程序（比如 ./test_runner），会在当前目录或对应源文件所在目录生成同名 .gcda 文件（如 main.gcda、test.gcda）。这个文件记录了本次运行中各分支/行的实际执行次数。

关键点：

AI音乐生成工具，创建生成音乐,与世界分享.

• 程序需正常退出（return 或 exit），异常终止或 kill 可能导致 .gcda 写入不全
• 多次运行同一程序，.gcda 会自动累加计数（适合多组测试用例合并统计）
• 若项目分多个可执行文件（如 unit_test、integration_test），各自运行后会生成各自的 .gcda

分析阶段：用 gcov 生成覆盖率报告

在源码目录下运行 gcov，例如：

会生成 main.cpp.gcov 文件，其中每行开头显示执行次数（##### 表示未执行，数字表示执行次数），直观反映行覆盖情况。

常用技巧：

• 加 -b 参数输出分支覆盖率（如 if/else、for 循环是否都走到）
• 加 -c 显示调用次数而非执行次数（对函数入口有用）
• 配合 lcov（gcov 的前端）生成 HTML 报告：用 lcov --capture --directory . --output-file coverage.info，再用 genhtml coverage.info --output-directory coverage_report

常见问题与注意事项

gcov 在 C++ 中容易踩坑，几个实用提醒：

• 模板实例化代码可能不显示在 .gcov 中——因为模板展开发生在编译期，且部分实现位于头文件，需确保头文件也参与编译（即 .h 也被 g++ 编译过，而非仅被 #include）
• 内联函数（inline）、constexpr 函数、宏定义不会单独计数，其逻辑计入调用处
• 链接静态库时，静态库的 .o 必须也是用 -fprofile-arcs 编译的，否则无覆盖率数据
• CI 环境中记得清理旧 .gcda（如 find . -name "*.gcda" -delete），避免历史数据干扰

基本上就这些。gcov 本身不复杂，但容易忽略编译一致性、运行完整性、头文件参与度这几个关键环节。