如何让Bazel识别含符号链接的WORKSPACE相对路径#include？

这是Bazel的既定行为，而非已知bug，源于Bazel对文件路径的规范化处理逻辑：

Bazel在构建过程中会自动解析所有符号链接到真实文件路径，并且在构建沙箱中仅保留真实路径结构，不会保留符号链接的虚拟路径映射。具体到你的场景：

• 根目录的foo -> libs/foo符号链接会被解析为真实路径libs/foo
• 编译阶段，沙箱内的文件结构是libs/foo/src/foo.cpp和libs/foo/itf/foo.h，不存在foo/itf/foo.h这个路径
• 因此#include "foo/itf/foo.h"会找不到对应的头文件

这种设计是Bazel为了保证构建一致性和可重复性的选择：符号链接在不同环境下可能存在解析差异，规范化到真实路径可以避免路径歧义导致的构建失败。

解决办法 #

针对你的场景，有几种可行的调整方案：

1. 修改#include路径为真实路径

   • 相对源文件的路径：将foo.cpp中的#include "foo/itf/foo.h"改为#include "../itf/foo.h"
   • 相对WORKSPACE的路径：改为#include "libs/foo/itf/foo.h"

2. 通过BUILD文件配置头文件搜索路径
   在cc_library中添加includes属性，让编译器能直接找到头文件：

   cc_library(
       name = "foo",
       srcs = ["src/foo.cpp"],
       hdrs = ["itf/foo.h"],
       includes = ["itf"],  # 添加后可直接#include "foo.h"
   )
   

   或者如果需要保留层级结构，可设置includes = ["."]，然后用#include "itf/foo.h"。

3. 依赖Bazel的目标管理
   若后续有其他目标依赖该库，通过deps = [":foo"]引入，Bazel会自动处理头文件的搜索路径，无需手动编写长路径。

内容的提问来源于stack exchange，提问作者Ton van den Heuvel