如何配置bazel coverage统计所有.h和.cc文件的代码覆盖率？

一、让所有.h/.cc文件被统计的配置调整 #

1. 启用头文件统计
   添加--experimental_cc_coverage_include_headers参数，该参数会强制Bazel将头文件（.h）纳入覆盖率统计——默认情况下实验性CC覆盖率规则会忽略头文件。

2. 确保目标被测试依赖或指定 instrumentation 过滤规则

• 如果某些文件所属的库目标未被任何测试目标依赖，Bazel会默认跳过统计。需将这些库添加到对应测试目标的deps中；若是无需测试的工具代码，可创建空测试目标来依赖它，触发统计流程。
• 也可通过--instrumentation_filter明确指定统计范围，比如用--instrumentation_filter="//..."匹配所有包下的文件，避免遗漏；若需更精确，可指定具体包路径：--instrumentation_filter="//src/...|//lib/..."。

3. 修正命令行参数格式
   你的命令中coverage_report_generator参数缺少前置--，正确写法为：

--coverage_report_generator=@bazel_tools//tools/test/CoverageOutputGenerator/java/com/google/devtools/coverageoutputgenerator:Main

二、解决未覆盖代码未被标记的问题 #

1. 关闭编译优化并保留调试信息
   Bazel编译测试目标时可能默认开启优化，导致未执行代码被编译器移除，无法被覆盖率工具检测。添加以下编译选项强制关闭优化：

--copt=-O0 --copt=-g --copt=-fno-elide-constructors

• -O0：关闭所有编译优化
• -g：生成调试信息，帮助覆盖率工具精准定位代码行
• -fno-elide-constructors：避免编译器优化掉拷贝构造函数等可能未被覆盖的代码（可选，根据代码场景添加）

2. 排查条件编译与宏定义
   若确认测试用例已覆盖某些代码但报告未显示，需检查代码是否被条件编译（如#ifdef）排除。此时需确保测试编译时启用对应宏定义，比如添加--copt=-DENABLE_FEATURE_X。

完整示例命令 #

整合所有参数后的完整命令如下：

bazel coverage \
  --instrument_test_targets \
  --experimental_cc_coverage \
  --experimental_cc_coverage_include_headers \
  --combined_report=lcov \
  --nocache_test_results \
  --coverage_report_generator=@bazel_tools//tools/test/CoverageOutputGenerator/java/com/google/devtools/coverageoutputgenerator:Main \
  --instrumentation_filter="//..." \
  --copt=-O0 \
  --copt=-g \
  //...

额外配置（可选） #

将常用参数写入项目根目录的.bazelrc文件，避免每次重复输入：

# .bazelrc
build:coverage --instrument_test_targets
build:coverage --experimental_cc_coverage
build:coverage --experimental_cc_coverage_include_headers
build:coverage --combined_report=lcov
build:coverage --nocache_test_results
build:coverage --coverage_report_generator=@bazel_tools//tools/test/CoverageOutputGenerator/java/com/google/devtools/coverageoutputgenerator:Main
build:coverage --instrumentation_filter="//..."
build:coverage --copt=-O0
build:coverage --copt=-g

之后只需执行bazel coverage --config=coverage //...即可触发配置好的覆盖率统计。

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