使用CMake预编译头(PCH)时clang-tidy运行报错找不到头文件问题排查

1. LLVM 12 版本存在明确的 clang-tidy 与预编译头（PCH）兼容缺陷：

• CMake 调用__run_co_compile包装器同时执行 clang-tidy 检查和 PCH 生成任务时，clang-tidy 无法正确识别-stdlib=libc++对应的内置标准库头文件搜索路径，也无法正确解析 PCH 生成阶段的-x c++-header、-emit-pch等特殊编译标记，导致头文件搜索链断裂，找不到标准库头文件。
• 手动添加-I/usr/lib/llvm-12/include/c++/v1不生效的原因是：clang-tidy 处理 PCH 相关文件时会优先读取 PCH 内嵌的头文件路径配置，外部传入的 include 路径优先级不足以覆盖这一逻辑，因此添加无效。

你可以根据自己的环境约束选择以下任意一种方案：

• 方案1：将 LLVM 版本升级到 14 及以上，该兼容问题在 LLVM 13 后续补丁和 LLVM 14 正式版中已被官方修复，升级后无需修改现有项目配置即可正常运行。
• 方案2：如果必须保留 LLVM 12 版本，可在 CMake 配置中添加规则，让 clang-tidy 跳过 PCH 生成文件的检查：

set(CMAKE_CXX_CLANG_TIDY_EXCLUDE ".*cmake_pch.*\\.cxx$")

• 方案3：无需升级版本，给 clang-tidy 额外添加优先级更高的标准库参数，注意必须使用--extra-arg-before保证参数在头文件搜索前生效：

set(CMAKE_CXX_CLANG_TIDY "clang-tidy;-extra-arg=-Wno-unknown-warning-option;-warnings-as-errors=*;--extra-arg-before=--driver-mode=g++;--extra-arg-before=--stdlib=libc++")

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