使用SonarQube社区插件cxx检测C++项目
内容提要
本文介绍SonarQube社区版通过cxx插件检测C++项目的方法。内容包括插件特性、安装步骤（下载兼容版本、复制jar包、重启服务）、卸载方式，以及源代码扫描流程、项目配置、SonarScanner使用和日志解读，并附故障排查建议。
延伸解读
版本兼容性：安装前必查
cxx插件与SonarQube版本存在严格兼容关系，不匹配可能导致服务无法启动或功能异常。安装前务必查阅官方兼容性矩阵，并备份现有配置。下载jar包时，需确认版本号与SonarQube对应，避免因版本冲突影响整个分析环境。
文件后缀唯一分配原则
SonarQube中每种文件后缀只能分配给一种编程语言。若同时运行多个C/C++相关插件，需通过sonar.cxx.file.suffixes参数明确指定cxx处理的文件类型，避免索引冲突。否则可能导致文件未被正确识别或分析结果不完整。
扫描日志的关键信息
扫描日志中，Plugins段落应显示C++ (Community)插件，Indexing files阶段会列出被索引的文件及语言，Run sensors阶段可观察CXX传感器的执行细节。若日志中传感器被跳过，通常因缺少必需属性，需检查项目配置。
Q&A
SonarQube社区版如何检测C++项目？
SonarQube社区版不直接支持C++检测，但可以通过安装社区插件cxx来实现。cxx插件支持多种C++标准（如C++03到C++23）和编译器扩展，适用于Windows和Linux。
如何安装cxx插件到SonarQube？
安装步骤：1. 从GitHub Releases下载与SonarQube版本兼容的jar包（如sonar-cxx-plugin-2.3.0.1496.jar）；2. 将jar复制到SONARQUBE_HOME/extensions/plugins目录；3. 完全停止SonarQube服务；4. 删除旧版本jar（如有）；5. 重新启动SonarQube。安装成功后，在Administration > Marketplace中可看到C++ (Community)插件。
如何卸载cxx插件？
卸载步骤：1. 停止SonarQube服务；2. 在extensions/plugins/目录删除sonar-cxx-plugin-2.3.0.1496.jar；3. 重启SonarQube。
使用cxx插件扫描C++项目时，如何配置sonar-project.properties文件？
在项目根目录创建sonar-project.properties文件，至少需要配置：sonar.projectKey（唯一标识）、sonar.cxx.file.suffixes（指定cxx处理的文件后缀，如.h,.cpp）。其他可选配置包括sonar.projectName、sonar.projectVersion、sonar.sources、sonar.sourceEncoding等。
运行SonarScanner需要哪些环境要求？
需要Java 11或Java 17环境，并设置环境变量JAVA_EXEC指向Java可执行程序。同时需要下载SonarScanner并解压，编辑conf/sonar-scanner.properties配置sonar.host.url指向SonarQube服务端地址。
如何验证cxx插件安装成功？
在SonarQube的Administration > Marketplace中查看已安装插件，如果列表中出现C++ (Community)即为安装成功。
扫描日志中如何确认cxx插件正常工作？
在扫描日志的Plugins段落中应看到C++ (Community)插件及其版本；在Run sensors on project阶段，会看到Sensor CXX [cxx]执行，并输出处理单元信息；最后日志末尾出现EXECUTION SUCCESS表示扫描成功。
cxx插件扫描C++项目时，文件索引是如何工作的？
文件索引是项目分析的第一步，根据文件后缀将文件分配给对应的编程语言。cxx插件通过sonar.cxx.file.suffixes配置的文件后缀（如.h,.cpp）来识别C++文件。只有被索引的文件才会在SonarQube前端展示。
