必须添加-fprofile-arcs和-ftest-coverage编译选项，否则lcov无法生成有效覆盖率数据；需在build目录执行lcov --capture；用lcov -r过滤第三方代码；genhtml报告需通过本地服务器查看。
编译时必须加 -fprofile-arcs -ftest-coverage
不加这两个 flag，后续所有 lcov 步骤都会“静默失败”：程序能跑，但生成的 .gcda 文件为空或根本没产生，lcov --capture 扫不到任何数据。这是最常卡住的地方。
实际编译命令示例（以 g++ 为例）：
g++ -g -O0 -fprofile-arcs -ftest-coverage main.cpp test.cpp -o mytest
-
-g必须带上，否则报告里看不到源码行号 -
-O0强烈建议，优化可能合并/删减代码块，导致覆盖率统计失真 - 如果用 CMake，得在
CMAKE_CXX_FLAGS或 target 的COMPILE_OPTIONS里显式追加那两个 flag，不能只靠set(CMAKE_BUILD_TYPE Coverage)这类模糊配置
lcov --capture 只扫当前目录及子目录下的 .gcda
运行测试后，.gcda 文件默认生成在目标文件（.o）所在目录，不是源码目录，也不是可执行文件目录。如果编译时用了独立的 build 目录（比如 build/），那 lcov --capture 就得进到 build/ 下执行，否则会提示 “found 0 traces”。
- 典型错误流程：
cd src/ && lcov --capture -d . -o coverage.base→ 扫不到，因为.gcda其实在build/CMakeFiles/xxx.dir/里 - 正确做法：
cd build && lcov --capture -d . -o coverage.base - 若项目有多个 build 子目录（如
build/test/,build/src/），需用-d多次指定，或先用find . -name "*.gcda" | xargs dirname | sort -u确认路径
过滤掉非业务代码（头文件、第三方、测试框架）要用 --remove
默认 lcov --capture 会把所有被编译过的文件（包括 gtest、boost、甚至系统头文件的模板实例化痕迹）都算进去，报告里出现大量 0% 的灰色区域，干扰判断。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
推荐在生成最终报告前做一次清洗：
lcov -r coverage.base '/usr/*' '/opt/*' '*/test/*' '*/gtest/*' '*mock*' -o coverage.filtered
-
-r是 remove，不是 exclude；-e才是 include，但通常先删再确认更安全 - 路径通配符用单引号包住，防止 shell 提前展开
- 注意顺序：
lcov --capture生成原始数据 →lcov -r过滤 →genhtml生成 HTML - 如果用了 header-only 库（如
fmt、spdlog），它们的头文件路径也要加进-r列表，否则会被计入覆盖率分母
genhtml 输出的 HTML 打不开？检查路径和浏览器限制
直接双击本地生成的 index.html，Chrome/Firefox 会因 file:// 协议禁止加载内联 JS（比如搜索框、折叠逻辑），页面显示空白或只有骨架。这不是生成失败，是浏览器策略。
- 最快验证方式：
python3 -m http.server 8000（在html/目录下），然后访问http://localhost:8000 - 如果想离线查看，用 Firefox 更稳定；Chrome 需启动时加
--unsafely-treat-insecure-origin-as-secure="file://"参数（不推荐日常使用） -
genhtml默认不压缩 JS/CSS，输出目录体积较大（尤其大项目），但改用--no-function-coverage可显著提速并减小体积，代价是函数级覆盖率数据丢失
真实项目里，.gcda 文件生命周期很短——重编译一次就清空，CI 中必须保证“编译 → 运行测试 → 立即 capture”三步在同一个构建环境里完成，中间换机器、清 workspace、甚至 git clean 都会导致数据丢失。这点比语法细节更容易被忽略。
