如何从CMake/clang/gcc/clang-tidy输出生成Code Climate报告

不要自己写正则解析构建日志，这条路我在多个几十万行级别的C++项目上踩过坑，不同GCC/Clang版本的输出差异、多行模板报错、彩色转义符、本地化输出、嵌套警告信息，会让正则维护成本高到无法接受，直接用结构化诊断输出中转的方案即可，完全适配CMake生态，且支持clang、gcc、clang-tidy三类工具的诊断整合。

核心实现思路 #

全程用结构化格式流转诊断数据，完全跳过非结构化日志解析的环节：

• GCC 12+、Clang 13及以上版本原生支持SARIF格式诊断输出，构建时给编译选项加-fdiagnostics-format=sarif-stderr即可直接输出标准结构化诊断结果，不存在格式兼容问题
• clang-tidy原生支持SARIF导出，执行检查时加--export-fixes=clang-tidy.sarif参数就能直接生成结构化结果，不需要解析控制台输出
• 所有工具输出的SARIF结果可以直接合并，再通过通用的SARIF转Code Climate格式的轻量脚本，转换成GitLab要求的质量报告格式即可，不需要为每个工具单独写适配逻辑

适配低版本编译器的兼容方案 #

如果项目用的GCC/Clang版本较老，不支持SARIF输出，也不要直接解析构建日志：

• CMake配置阶段加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON，生成compile_commands.json编译数据库，所有源文件的编译参数、路径信息全量结构化导出
• 用成熟的编译包装器接管实际编译调用，包装器内部已经适配了从GCC 4.8到最新版、Clang全版本的诊断输出格式，自动处理多行报错、转义符、本地化输出等边缘场景，直接输出统一结构化结果
• clang-tidy直接基于编译数据库运行，输出结果和编译器诊断结果合并即可

GitLab CI配置步骤 #

整个流程对现有CMake构建逻辑侵入性极低：

• CMake配置阶段按需开启编译数据库导出、编译器SARIF输出参数
• 正常执行项目构建、clang-tidy静态检查步骤，收集所有生成的SARIF格式诊断文件
• 合并多份SARIF结果并做简单去重（避免同一个问题被多个工具重复上报），转换为GitLab认可的Code Climate格式，命名为gl-code-quality-report.json
• 在CI任务配置中将该文件声明为codequality类型的产物，提交后GitLab会自动解析，直接在MR、流水线页面展示所有警告、错误的位置、详情、严重级别

避坑提示 #

• 构建时记得加-fno-color-diagnostics编译参数或者设置TERM=dumb环境变量，避免彩色输出的转义符污染结构化结果
• 不要用零散的第三方正则解析脚本，这类脚本基本只覆盖了单版本编译器的单行警告场景，遇到复杂报错直接失效
• 如果需要统计警告增量，直接基于结构化结果做diff即可，比对比构建日志准确率高100%

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