clang-tidy 是基于 clang ast 的 c++ 静态分析工具，用于检测 bug、风格、性能及安全问题；可通过 cmake 生成 compile_commands.json 后运行 clang-tidy -p . file.cpp，支持按组启用规则（如 modernize-*）、编辑器集成、git 预提交检查、ci 警告级接入及 -fix 自动修复。
Clang-Tidy 是 LLVM 项目提供的 C++ 静态分析工具，能自动检测代码中潜在的 bug、风格问题、性能隐患和不安全用法。它不是编译器，而是基于 Clang AST 的“检查器集合”，可集成进开发流程，真正落地代码质量管控。
怎么快速上手运行 Clang-Tidy
最直接的方式是配合 CMake 项目使用：
1. 确保已安装 clang++ 和 clang-tidy（通常随 LLVM 或 Clang 发行版一起提供）
2. 在 CMakeLists.txt 中开启导出编译命令：set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
3. 构建项目后，根目录会生成 compile_commands.json
4. 执行：clang-tidy -p . [file.cpp]，例如：clang-tidy -p . src/main.cpp
常用检查项与启用方式
Clang-Tidy 自带上百个检查器（checkers），默认只开一小部分。可通过以下方式控制：
- 启用特定组：clang-tidy -p . -checks="modernize-*"
- 启用多个独立规则：clang-tidy -p . -checks="cppcoreguidelines-*,bugprone-*"
- 排除某类规则：clang-tidy -p . -checks="*, -llvm-namespace-comment"
- 常用推荐组合：-checks="-*,cppcoreguidelines-*,modernize-*,performance-*,bugprone-*,cert-*"（兼顾权威指南与实用性）
集成进日常开发流程
静态分析只有“看得见、跑得动、改得顺”才算真正可用：
- 编辑器集成：VS Code 安装 C/C++ Extension Pack + 配置 "clang-tidy.args"；CLion 内置支持，可设为 on-the-fly 检查
- Git 提交前检查：用 pre-commit hook 调用 clang-tidy，只检查暂存文件（避免全量扫描拖慢体验）
- CI 流水线中加入：失败时输出问题摘要，但建议设为 warning 级别而非硬性失败，降低阻塞感
- 生成 HTML 报告（需额外工具）：用 clang-tidy -export-fixes=fixes.yaml 导出修复建议，再配合脚本转成可视化报告
修复建议与自动修正
Clang-Tidy 不仅报错，还能自动修复大部分风格类问题：
- 加 -fix 参数触发原地修改：clang-tidy -p . -fix -checks="modernize-loop-convert"
- 用 -fix-errors 尝试修复导致编译失败的问题（如类型不匹配）
- 修改前务必提交或备份，尤其批量 fix 时——有些自动改写逻辑在复杂模板场景下可能误伤
- 对于无法自动修复的问题（如设计缺陷、资源泄漏），它会给出精准定位 + 说明，方便人工跟进
基本上就这些。Clang-Tidy 不复杂但容易忽略配置粒度和落地节奏——选对检查集、嵌入编辑器、轻量跑在 CI，比堆满规则却没人看更有效。
