SonarQube为何忽略gcovr生成的C++代码覆盖率数据？

1. 扩展SonarQube的源代码范围 #

日志中出现的头文件（如include/project_headers/file2.hpp）不在当前sonar.sources配置范围内，导致SonarQube将其判定为未知文件。需要把项目的头文件目录加入源代码范围，同时排除第三方头文件：

sonar.sources=Project_Root/src/,Project_Root/include/
sonar.exclusions=**/src/3p_stack/**,**/include/boost_headers/**

2. 统一gcovr报告的路径格式 #

当前gcovr生成的路径使用反斜杠\，且未基于项目根目录生成，导致与SonarQube的路径匹配失败。生成报告时指定项目根目录，输出正斜杠格式的相对路径：

gcovr --root Project_Root --xml -o Project_Root/artifacts/coverage.xml

这样生成的报告中路径会变为src/file2.cpp、include/project_headers/file2.hpp，与SonarQube的源代码路径完全匹配。

3. 配置覆盖率路径基准（可选） #

如果调整gcovr参数后仍存在路径匹配问题，可添加sonar.coveragePaths参数，明确覆盖率报告中路径的基准目录：

sonar.coveragePaths=Project_Root/

该参数会告诉SonarQube，覆盖率报告里的相对路径均基于Project_Root/，帮助系统正确关联到源代码文件。

4. 验证排除规则 #

确认修改后的sonar.exclusions未误排除需要统计覆盖率的src/file2.cpp、src/file3.cpp等文件，以及对应的项目头文件。

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