如何在Bazel中可选覆盖仓库依赖并按需加载WORKSPACE.user.bazel文件？

一、可选覆盖仓库依赖 #

以下是几种适合开发阶段的可选依赖覆盖方案，不会干扰正式构建流程：

1. 结合环境变量使用override_repository #

通过环境变量控制override_repository是否生效，既灵活又不会污染主WORKSPACE配置：

# 声明默认远程依赖
http_archive(
    name = "some_dep",
    urls = ["https://example.com/some_dep-v1.0.tar.gz"],
    sha256 = "abc123...",
)

# 仅当指定环境变量存在时，覆盖为本地依赖
if "OVERRIDE_SOME_DEP" in os.environ:
    override_repository(
        name = "some_dep",
        path = os.environ["OVERRIDE_SOME_DEP"],
    )

开发时执行export OVERRIDE_SOME_DEP=/path/to/local/some_dep即可启用本地依赖，正式构建时不设置该变量就会使用默认远程版本。

2. 基于本地目录存在性自动切换 #

直接检查本地是否有目标依赖目录，存在则用本地版本，否则拉取远程：

if native.exists("/path/to/local/some_dep"):
    local_repository(
        name = "some_dep",
        path = "/path/to/local/some_dep",
    )
else:
    http_archive(
        name = "some_dep",
        urls = ["https://example.com/some_dep-v1.0.tar.gz"],
        sha256 = "abc123...",
    )

二、条件加载WORKSPACE.user.bazel文件 #

要实现仅当该文件存在时才加载，可在主WORKSPACE.bazel中加入以下逻辑：

# 检查用户自定义WORKSPACE文件是否存在，存在则加载
if native.exists("WORKSPACE.user.bazel"):
    load("//:WORKSPACE.user.bazel", workspace_user_content = "content")
    workspace_user_content()

然后在WORKSPACE.user.bazel中把自定义依赖逻辑封装成函数：

def content():
    # 这里写开发专属的依赖覆盖逻辑
    override_repository(
        name = "some_dep",
        path = "../local/some_dep",
    )

最后将WORKSPACE.user.bazel添加到.gitignore，避免提交到代码库。

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