如何使用Bazel从私有仓库导入Go模块？

方案一：通过Git克隆方式拉取（推荐） #

私有仓库需要权限验证，Bazel默认的HTTP压缩包下载无权限会返回404，改成Git克隆方式即可。在WORKSPACE中配置go_repository时指定Git远程地址和版本控制系统：

go_repository(
    name = "com_github_my_private_repo_my_package",
    commit = "abc1234567890abcdef1234567890abcdef12345", # 替换为你的依赖commit哈希
    importpath = "github.com/<my-private-repo>/<my-package>",
    remote = "git@github.com:<my-private-repo>/<my-package>.git", # 私有仓库SSH地址
    vcs = "git",
)

凭证准备： #

• 确保本地已配置GitHub SSH密钥，且密钥已添加到ssh-agent（可通过ssh-add ~/.ssh/id_rsa加载），能无密码克隆私有仓库。
• 若偏好HTTPS，可先配置Git凭证缓存：

  git config --global credential.helper store
  

  第一次手动克隆私有仓库时输入用户名和GitHub个人访问令牌（PAT），之后Git会自动复用凭证，此时remote可改为HTTPS地址：https://github.com/<my-private-repo>/<my-package>.git

方案二：通过环境变量配置认证 #

在项目根目录的.bazelrc中添加Git认证相关配置，或直接设置环境变量让Bazel拉取时带上权限：

• 配置.bazelrc：

  build --action_env=GIT_SSH_COMMAND="ssh -i /path/to/your/private/key"
  

• 临时设置环境变量（终端会话内生效）：

  export GIT_SSH_COMMAND="ssh -i ~/.ssh/id_rsa"
  

方案三：基于vendor目录管理依赖 #

如果不想配置远程拉取，可先用go mod vendor将私有依赖下载到本地vendor目录，再在Bazel中引用：

1. 执行go mod vendor下载依赖到项目根目录的vendor文件夹
2. 在WORKSPACE中配置：

   go_repository(
       name = "com_github_my_private_repo_my_package",
       importpath = "github.com/<my-private-repo>/<my-package>",
       path = "./vendor/github.com/<my-private-repo>/<my-package>",
   )
   

3. 在BUILD.bazel的Go目标中正常引用该依赖即可

注意： #

这种方式需要手动维护vendor目录，依赖更新时需重新执行go mod vendor同步。

排查要点 #

• 核对importpath、commit、remote地址的拼写，确保与私有仓库完全一致
• 先手动测试Git能否正常克隆私有仓库，排除网络或凭证本身的问题
• 使用SSH时，确认ssh-agent已加载对应密钥，避免Bazel拉取时权限不足

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