Clang-Tidy在CI中默认不中断构建，因其退出码恒为0；需用--warnings-as-errors指定高危规则、验证compile_commands.json存在、补全-std等参数、过滤头文件并加-quiet和|| exit 1兜底。
Clang-Tidy 在 CI 中默认不会中断构建，即使发现 bugprone-unused-return-value 或 cppcoreguidelines-pro-bounds-array-to-pointer-decay 这类高危问题，它也只输出警告——构建照样成功。必须显式干预退出码，才能让 CI 真正“拦截”。
CI 中 clang-tidy 为什么总不报错？
根本原因在于：clang-tidy 默认退出码是 0，无论有没有诊断信息。CI 流程只看退出码，不 parse 日志文本。
- 不加
--warnings-as-errors，哪怕触发了performance-unnecessary-copy-initialization（可能造成百倍性能下降），构建仍会通过 - 用
-p build/但路径错误（比如build/下没有compile_commands.json），clang-tidy 会静默跳过所有文件，输出空结果 + 退出码0，CI 完全感知不到失败 - 部分规则（如
cppcoreguidelines-*）依赖 C++ 标准版本，若未传-extra-arg=-std=c++17，AST 解析不全，规则直接不激活，且无提示
如何让 clang-tidy 在 CI 中真正失败
关键不是“运行它”，而是“让它失败得明确、可复现、不误伤”。
- 强制升为错误：
--warnings-as-errors="bugprone-*,performance-*,cppcoreguidelines-pro-*"—— 只针对高风险类别，避免*引入大量低价值噪声 - 确保编译数据库可用：
clang-tidy -p build/ src/**/*.cpp前，必须验证build/compile_commands.json存在且非空；CMake 配置中要确认-DCMAKE_EXPORT_COMPILE_COMMANDS=ON已生效 - 补全缺失编译参数：用
--extra-arg=-std=c++20 --extra-arg=-Iinclude显式传递关键参数，尤其当compile_commands.json因跨平台或交叉编译生成不全时 - 过滤头文件干扰：加
-header-filter='^(src|include)/'，避免第三方库或系统头触发误报（如cppcoreguidelines-pro-type-vararg在
GitLab CI / GitHub Actions 实操片段
以下命令在真实流水线中验证有效，不依赖任何 wrapper 脚本：
clang-tidy -p build/ src/*.cpp \ --warnings-as-errors="bugprone-*,performance-*,cppcoreguidelines-pro-*" \ --extra-arg=-std=c++20 \ -header-filter='^(src|include)/' \ -quiet || exit 1
-
-quiet抑制非错误类输出（如Loaded 123 checks），避免日志污染；真正的问题行以error:开头，CI 日志可直接定位 -
|| exit 1是兜底保险：即使 clang-tidy 因路径错误等提前退出（返回非零但非1），该语句仍确保整个步骤失败 - 不要用
run-clang-tidy脚本：它内部调用逻辑复杂，对--warnings-as-errors支持不稳定，且无法精确控制-header-filter
容易被忽略的兼容性陷阱
同一个 .clang-tidy 配置，在本地和 CI 中行为可能不一致——不是配置错了，而是环境链路断了。
-
Checks里写cppcoreguidelines-*，但在 CI 的 LLVM 版本中该模块未编译进 clang-tidy（例如某些精简版 apt 包），clang-tidy -list-checks | grep cppcore输出为空，规则完全不加载 - CMake 生成的
compile_commands.json记录的是绝对路径（如/home/ci/project/src/main.cpp），而 CI runner 使用容器挂载，实际路径变成/workspace/src/main.cpp，导致 clang-tidy 找不到源文件，静默跳过 - 启用
modernize-use-auto后，CI 中 clang-tidy 尝试自动修复（--fix），但若项目没配.clang-format，格式化失败会导致整个检查中断并返回非零退出码，被误判为“分析失败”而非“格式问题”
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
