使用clang-tidy分析Bazel项目时无法找到间接引入头文件

在Bazel项目中运行clang-tidy时，已生成看似有效的compile_commands.json，执行命令：

clang-tidy -p /path/to/compile_commands.json /path/to/cpp/file.cpp

出现无法找到间接引入头文件的错误。已验证用原工具链（RHEL GCC）执行compile_commands.json中的编译命令，file.cpp可正常编译。尝试将-p指向编译数据库所在目录、去掉-p参数均出现相同错误；删除compile_commands.json则报错不同，说明clang能读取编译数据库，但未正确找到目标所需头文件。

已尝试方案：

• 将-p参数改为指向编译数据库所在目录而非文件本身；
• 去掉-p参数，结果相同；删除compile_commands.json报错不同，确认clang可读取编译数据库。

请问可能遗漏了什么？

针对Bazel+clang-tidy的场景，这类问题通常和以下几点相关，可逐一排查：

1. 编译命令路径与工作目录不匹配 #

Bazel默认在沙盒环境编译，生成的compile_commands.json里的编译命令可能包含相对于Bazel输出目录的路径（比如bazel-out/...下的相对路径）。如果在项目根目录运行clang-tidy，这些相对路径会指向错误位置，导致头文件找不到。

• 解决：切换到compile_commands.json所在的Bazel输出目录（如bazel-bin对应目录）再执行clang-tidy；或在命令中添加--working-directory=/path/to/bazel/output/dir指定工作目录。

2. clang-tidy与GCC的头文件路径不兼容 #

RHEL上GCC的系统头文件路径和clang默认路径可能不一致，尤其是间接引入的系统头文件。此外，Bazel为GCC设置的私有头路径、宏定义，clang-tidy可能无法自动继承。

• 解决：从compile_commands.json中提取目标文件对应编译命令里的-I、-isystem、-D等参数，手动添加到clang-tidy命令中。示例：

  clang-tidy -p /path/to/compile_commands.json -I/path/to/dep/include -isystem/usr/lib/gcc/x86_64-redhat-linux/11/include /path/to/cpp/file.cpp
  

3. compile_commands.json生成不完整 #

手动或旧工具生成的编译数据库可能遗漏Bazel依赖的第三方库、规则头文件路径（如@com_google_absl这类外部依赖的头路径）。

• 解决：使用适配Bazel的专用工具生成编译数据库，比如bazel-compile-commands-extractor，它能正确遍历Bazel依赖图，写入所有必要的头路径和编译参数。使用方式：

  bazel run @bazel_compile_commands_extractor//:refresh_all
  

4. clang-tidy与Bazel使用的clang版本不匹配 #

如果Bazel用指定版本clang编译，而你运行的clang-tidy是另一版本，可能存在兼容性问题，导致路径解析错误。

• 解决：确保clang-tidy版本与Bazel编译时使用的clang版本一致；或直接通过Bazel调用clang-tidy（如bazel run //:clang-tidy），让Bazel统一管理工具链和路径。

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