如何读取gcno、gcda文件使用gcovr统计测试覆盖率并解决结果异常问题

核心原因分析 #

你遇到的两次统计结果不符合预期，本质是gcovr默认统计规则的问题：

• gcovr默认仅将有对应gcda生成记录的文件纳入覆盖率计算的分母，完全未被测试程序链接、无gcda生成的源码文件不会被计入统计，因此会出现覆盖率虚高的问题。
• 你未配置过滤规则，测试代码、示例代码、头文件中未被调用的inline/模板函数也被纳入统计，进一步干扰了结果。

编译链接配置修正 #

• 所有编译/链接阶段统一使用--coverage参数即可，无需额外添加-lgcov，新版本gcc的--coverage会自动处理链接依赖。
• 编译时使用-O0 -g参数关闭优化、保留调试信息，避免优化导致行号映射错乱、覆盖率统计不准。
• 第三方依赖库无需添加--coverage参数，避免无关代码被纳入统计。

gcovr调用参数修正 #

你需要调整gcovr的调用参数，实现全代码库统计+无效内容过滤，核心参数说明如下：

• --root <代码根目录>：指定要统计的源码根路径，所有计算均以该路径为基准。
• --object-directory <gcno/gcda存放目录>：指定编译产物的搜索路径，无需手动罗列每个测试程序的路径。
• --all-sources：强制将根目录下所有源码文件纳入统计，无gcda记录的文件按覆盖率0%计算，确保覆盖率分母为全代码库的有效代码行数。
• --exclude <正则规则>：过滤不需要统计的路径，比如测试代码、示例代码、第三方依赖目录。
• --exclude-unreachable-branches/--exclude-throw-branches：过滤不可达分支、异常抛出分支的统计，避免无意义的未覆盖记录。

正确调用示例 #

假设你的源码根目录为../Src，编译产物（gcno/gcda）存放在当前执行目录，需要排除tests目录、examples目录的代码：

gcovr \
  --root ../Src \
  --object-directory . \
  --all-sources \
  --exclude ".*/tests/.*" \
  --exclude ".*/examples/.*" \
  --exclude-unreachable-branches \
  --exclude-throw-branches

结果验证 #

调整参数后，所有未被测试用例触及的源码文件都会被纳入分母按0%计算，测试代码、示例代码也会被过滤，最终覆盖率会符合你预期的低于1%的结果。

内容的提问来源于stack exchange，提问作者Makogan