多仓库环境下如何复用Bazel构建缓存？

Bazel的缓存键是基于目标的完整标签（包含仓库标识）生成的，你遇到的问题本质是@repo-a//foo/bar:hello和//foo/bar:hello被判定为两个独立目标，因此无法复用彼此的缓存结果。可以通过以下几种方式解决：

1. 给子仓库显式指定工作区名称 #

在每个子仓库的WORKSPACE文件中添加workspace(name)声明，强制子仓库使用固定的仓库标识：

# repo-a/WORKSPACE
workspace(name = "repo-a")

这样在子仓库内执行bazel build //foo/bar:hello时，Bazel会自动将目标解析为@repo-a//foo/bar:hello，和根目录构建的目标标签完全一致，缓存自然就能复用。

2. 构建时临时指定工作区名称 #

如果不想修改子仓库的配置，可以在子仓库构建时通过命令行参数覆盖默认工作区名称：

myproject/repo-a $ bazel build --workspace_name=repo-a //foo/bar:hello

这个参数会让Bazel将当前子仓库的目标标签统一加上@repo-a前缀，和根目录的构建目标匹配，实现缓存共享。

3. 确保根目录WORKSPACE配置匹配 #

根目录的WORKSPACE中引用子仓库时，要保证name字段和子仓库指定的工作区名称一致，比如使用local_repository的场景：

# myproject/WORKSPACE
local_repository(
    name = "repo-a",
    path = "./repo-a",
)

这是基础前提，确保根目录能正确识别子仓库的身份，避免标签歧义。

注意事项 #

• 所有子仓库都需要统一设置工作区名称，或者构建时统一使用--workspace_name参数，才能保证全场景下的目标标签一致性。
• 该方案不仅适用于本地缓存，也能让远程缓存的复用逻辑正常生效，核心是保证了缓存键的一致性。

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