编译时必须加-g -O0 -fprofile-arcs -ftest-coverage，否则gcov找不到覆盖率数据；-g保留符号信息，-O0避免优化干扰统计，后两者启用gcov插桩；CMake中需为测试target设置对应编译链接标志。
编译时必须加 -g -O0 -fprofile-arcs -ftest-coverage
不加这组 flag，后续所有 lcov 步骤都会失败——gcov 找不到覆盖率数据，lcov 读不到 .gcda 文件。其中：-g 是必须的（否则符号信息缺失，报告里看不到源码行）；-O0 推荐强制开启（优化可能合并/删减代码块，导致行覆盖统计失真）；-fprofile-arcs 和 -ftest-coverage 才是真正启用 gcov 插桩的关键。
常见错误：只加了 -fprofile-arcs 忘了 -ftest-coverage，结果编译通过但运行后没生成 .gcda；或者用 -O2 编译，测试跑完发现某些函数显示“no data found”。
- 如果是 CMake 项目，在
CMakeLists.txt中对测试 target 加：set_target_properties(your_test_target PROPERTIES COMPILE_FLAGS "-g -O0 -fprofile-arcs -ftest-coverage" LINK_FLAGS "-fprofile-arcs -ftest-coverage")
- 手动编译示例：
g++ -g -O0 -fprofile-arcs -ftest-coverage test.cpp -o test && ./test
运行后当前目录应出现test.gcda
lcov 抓取数据前先用 --initial 捕获基线
直接 lcov --capture 会混入系统头文件、第三方库的垃圾数据，导致覆盖率虚高或报告混乱。正确流程是两步：先用 --initial 抓编译产物的结构（即 .gcno 对应的“骨架”），再运行测试后抓实际执行数据（.gcda），最后用 --add 合并。
- 生成基线：
lcov --directory . --capture --initial --output-file coverage_base.info
- 运行测试（确保
.gcda已生成） - 抓取运行数据：
lcov --directory . --capture --output-file coverage_test.info
- 合并：
lcov --add coverage_base.info coverage_test.info --output-file coverage_total.info
漏掉 --initial 是新手最常踩的坑——报告里会冒出大量 /usr/include/... 或空函数体，过滤起来极麻烦。
立即学习“C++免费学习笔记（深入）”；
过滤掉非目标代码用 --remove 和 --include
lcov 默认扫整个 --directory 下所有 .gcda，包括构建中间文件、测试框架代码、甚至你 clone 下来的第三方子模块。必须显式过滤，否则报告不可信。
- 排除构建目录和测试代码本身（假设源码在
src/，测试在test/）：lcov --remove coverage_total.info '/usr/*' '*/test/*' '*/build/*' '*/cmake/*' --output-file coverage_filtered.info
- 更稳妥的做法是只保留目标路径：
lcov --extract coverage_total.info 'src/*' --output-file coverage_filtered.info
- 注意路径通配符是 shell 级展开，如果路径含空格或特殊字符，需加引号；
lcov内部匹配基于文件系统路径字符串，不是正则
用 genhtml 生成可读报告时别忽略 --show-details
默认 genhtml 只显示函数级汇总，点进去才看到行覆盖。加 --show-details 能让首页表格直接列出每行命中次数，排查“为什么这行没覆盖”快得多。
- 基础命令：
genhtml coverage_filtered.info --output-directory coverage_report
- 带详情和标题：
genhtml coverage_filtered.info --output-directory coverage_report --show-details --title "My Project Coverage"
- 生成后打开
coverage_report/index.html，红色高亮 = 0 次执行；黄色 = 部分分支未走；绿色 = 完全覆盖
容易被忽略的是：如果 .gcno 和 .gcda 不在同一目录，或源码移动过位置，genhtml 会报 cannot find source file —— 这时要用 --source-directory 指定原始源码路径，而不是当前工作目录。
