clang-tidy代码分析中如何排除external第三方库目录？

可能的原因及对应方案 #

1. 修正 HeaderFilterRegex 的正则匹配逻辑 #

HeaderFilterRegex 失效往往是因为正则没有匹配到头文件的实际路径。clang-tidy 匹配的是头文件的完整路径，而非相对路径，所以需要根据实际路径调整正则：

• 若项目根目录下的 srcA/srcB 是源码目录，可使用绝对路径正则：

  clang-tidy -p build ./srcA/**/*.cpp ./srcB/**/*.cpp -header-filter='^/path/to/your/project/(srcA|srcB)/'
  

• 或用相对路径正则（需确保命令在项目根目录执行）：

  clang-tidy -p build ./srcA/**/*.cpp ./srcB/**/*.cpp -header-filter='^./(srcA|srcB)/'
  

可通过添加 -v 参数查看 clang-tidy 处理的头文件路径，验证正则是否匹配。

2. 在 CMake 中隔离第三方库的编译配置 #

如果第三方库是通过 add_subdirectory(external) 加入项目的，CMake 会默认将 clang-tidy 配置应用到所有目标，包括第三方库。可通过临时清空 clang-tidy 配置来避免：

# 保存当前项目的 clang-tidy 设置
set(OLD_CLANG_TIDY ${CMAKE_CXX_CLANG_TIDY})
# 清空配置，跳过第三方库的 clang-tidy 分析
set(CMAKE_CXX_CLANG_TIDY "")
add_subdirectory(external)
# 恢复配置，仅应用到自有源码目标
set(CMAKE_CXX_CLANG_TIDY ${OLD_CLANG_TIDY})

3. 使用 --exclude 参数直接排除第三方目录（Clang 12+ 支持） #

新版本 clang-tidy 提供 --exclude 参数，可直接跳过指定目录的分析：

clang-tidy -p build ./srcA/**/*.cpp ./srcB/**/*.cpp --exclude='./external/**'

注意该参数仅在 Clang 12 及以上版本可用，需先检查你的 clang-tidy 版本。

4. 检查检查器是否跨文件触发部分错误 #

部分 clang-tidy 检查器（如 misc-definitions-in-headers）会在分析源文件时，将包含的第三方头文件中的问题也上报。此时可通过调整检查器列表，禁用这类跨文件检查，或确保仅启用针对自有代码的检查：

clang-tidy -p build ./srcA/**/*.cpp ./srcB/**/*.cpp -checks='-*,readability-*,performance-*' -header-filter='^./(srcA|srcB)/'

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