clang-tidy

Clang 静态分析与自动修复

补充说明

clang-tidy 基于 Clang AST 检查 C/C++ 代码，支持风格、现代化、性能和 bug 类规则，并可自动修复部分问题。

常用示例

clang-tidy src/app.cpp -- -std=c++20 -Iinclude
clang-tidy -p build src/app.cpp
clang-tidy -p build --checks='-*,bugprone-*,modernize-*' src/app.cpp
clang-tidy -p build --fix src/app.cpp
clang-tidy -p build --fix-errors src/app.cpp
run-clang-tidy -p build -j 8

.clang-tidy：

Checks: >
  bugprone-*,
  modernize-*,
  performance-*,
  -modernize-use-trailing-return-type
WarningsAsErrors: ''
HeaderFilterRegex: 'src/.*'

易错点与排错

• 需要 compile_commands.json 才能正确处理 include/宏；用 -p build。
• 自动修复会改代码；先提交或审查 diff，再逐条验证。
• 规则集变化大；CI 固定 clang-tidy 版本和 checks。
• 头文件检查会产生大量告警；用 HeaderFilterRegex 限制。
• --fix 可能与其他规则冲突；分多次小步修复。
• 模板/宏密集代码可能解析失败；看编译数据库是否完整。
• 它不是编译器替代品；构建和测试仍必须跑。

相关命令

• clang-tidy — 静态分析
• cppcheck — 另一种静态检查
• cmake — 生成 compile_commands.json