如何让Clang-Tidy忽略Conan缓存~/.conan下的第三方头文件？

Clang-Tidy默认会跳过系统头文件的诊断输出，所以核心思路是把Conan依赖的目录标记为系统包含目录，或者精准指定只检查业务代码范围，以下是几种可行的具体方案：

方案1：通过Conan配置自动标记依赖为系统目录 #

如果你使用Conan 2.x，可以通过配置让Conan生成的CMake工具链自动将所有依赖的include目录标记为系统目录，无需手动修改CMake：

• 在conanfile.txt中添加全局配置：

  [conf]
  tools.cmake.cmaketoolchain:system_include_directories=*
  

  该配置会让所有Conan安装的依赖（包括fmt）的include目录被CMake识别为系统目录，Clang-Tidy会自动忽略这些目录的诊断。
• 若只想针对特定依赖（如仅fmt）设置：

  [conf]
  tools.cmake.cmaketoolchain:system_include_directories=["fmt"]
  

方案2：在CMake中指定Clang-Tidy仅检查业务代码 #

直接通过-header-filter参数限定Clang-Tidy的检查范围，假设你的业务代码都在项目根目录的src/和include/文件夹下，在CMakeLists.txt中添加：

set(CMAKE_CXX_CLANG_TIDY "clang-tidy;-header-filter=^${CMAKE_SOURCE_DIR}/(src|include)/")

这个正则表达式会让Clang-Tidy只处理匹配到的业务代码文件，~/.conan下的依赖文件会被自动排除。注意要根据你的实际代码目录结构调整正则规则。

方案3：手动将依赖目录标记为系统目录 #

如果前两种方案不生效，可以手动将Conan依赖的include目录设置为系统目录。以fmt为例：

find_package(fmt REQUIRED)
include_directories(SYSTEM ${fmt_INCLUDE_DIRS})

SYSTEM关键字会告诉CMake该目录是系统头文件目录，Clang-Tidy会跳过对其中文件的诊断。

额外：调整.clang-tidy配置关闭系统头文件检查 #

如果项目中存在.clang-tidy配置文件，部分检查（如clang-analyzer-*系列）可能默认会扫描系统头文件，可以添加以下配置关闭：

CheckOptions:
  - key: clang-analyzer-optin.cplusplus.UninitializedObject:CheckSystemHeaders
    value: false

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