用途:指导代理为 C/C++ 项目选择、运行并分类处理静态分析工具(clang-tidy、cppcheck、scan-build),涵盖抑制策略与 CI 集成。触发场景包括运行 clang-tidy、选择检查项、抑制 cppcheck 误报、设置 scan-build、处理构建告警、生成 compile_commands.json。
核心流程:先生成编译数据库,如 cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON 并建立符号链接,或对 Make 项目使用 bear -- make、compiledb make。
clang-tidy:单文件运行 clang-tidy src/foo.c -- -std=c11 -I include/,项目级用 run-clang-tidy -p build/ -j$(nproc),可用 -checks 指定 bugprone-、modernize-、performance-* 等,-fix 应用自动修复。检查类别按目标选择:找真实缺陷用 bugprone-、clang-analyzer-;现代化用 modernize-;核心指南用 cppcoreguidelines-;性能用 performance-;安全加固用 cert-、hicpp-;可读性用 readability-、llvm-*。可配置 .clang-tidy 文件设定 Checks、WarningsAsErrors、HeaderFilterRegex、CheckOptions。误报可用 NOLINT、NOLINTNEXTLINE、clang::suppress 或在配置中排除第三方目录与特定检查。
cppcheck:如 cppcheck --enable=all --std=c11 src/,可用 --project 读取 compile_commands.json,按 warning、performance、portability 等启用检查,用 --suppress 抑制噪音,--error-exitcode=1 控制退出码,--xml --xml-version=2 生成 CI 报告。
scan-build:通过 scan-build make 或 scan-build cmake --build build/ 拦截构建,scan-view 查看 HTML 报告,可启用特定 checker;相比 clang-tidy 能发现跨函数释放后使用、死存储、复杂路径空指针解引用等更深层问题。
CI 集成:GitHub Actions 中导出 compile_commands.json 后运行 run-clang-tidy -p build -j$(nproc) -warnings-as-errors '*',以及 cppcheck 带 --error-exitcode=1。
相关技能:Clang/GCC 工具链诊断标志、sanitizers 运行时缺陷检测、CMake 配置。限制:资料未提供具体性能数据、收费信息或平台支持范围。