VSCode Go扩展加载含私有仓库依赖的工作区时报错的问题咨询

我之前也碰到过类似的私有仓库导致VSCode Go代码补全失效的问题，咱们一步步拆解解决：

为什么代码补全需要访问私有仓库？ #

VSCode的Go代码补全依赖gopls（Go语言服务器），而gopls为了提供准确的代码提示，必须完成这些核心操作：

• 验证私有仓库的模块合法性，通过访问Bitbucket API确认它属于Git/Mercurial等版本控制系统
• 加载依赖模块的完整类型定义、接口结构等元数据，这些信息需要从私有仓库拉取（尤其是首次加载或依赖更新后）
• 同步依赖的版本信息，确保补全的代码和你项目中实际使用的依赖版本完全一致

简单说：gopls需要完整解析你的项目依赖树，私有仓库作为其中一环，必须能被正常访问才能完成这个过程。

如何为Go扩展提供SSH密钥？ #

1. 先确保本地SSH配置正常 #

首先确认你已经生成SSH密钥并添加到Bitbucket账户中，然后在~/.ssh/config（Windows路径为C:\Users\<你的用户名>\.ssh\config）中添加Bitbucket专属配置：

Host bitbucket.org
  IdentityFile ~/.ssh/你的私有密钥文件名（比如id_rsa_bitbucket）
  User git

测试连接是否正常：运行ssh -T git@bitbucket.org，如果返回成功提示，说明本地SSH配置没问题。

2. 告诉Go工具链这是私有仓库 #

运行以下命令设置GOPRIVATE环境变量，让Go知道该仓库不需要走公共模块代理，直接用SSH访问：

go env -w GOPRIVATE=bitbucket.org/my-group/my-private-repo

如果有多个私有仓库，用逗号分隔即可：go env -w GOPRIVATE=bitbucket.org/my-group/*,github.com/your-username/private-*

3. 让VSCode的Go扩展继承SSH配置 #

打开VSCode设置（快捷键Ctrl+,），搜索并打开settings.json，添加以下配置：

{
  "go.goplsEnv": {
    "GOPRIVATE": "bitbucket.org/my-group/my-private-repo",
    // 不同系统的SSH代理路径不一样：
    // Linux: "/run/user/1000/keyring/ssh"
    // macOS: "/var/run/ssh-agent.sock"
    // Windows: 确保OpenSSH服务在运行，一般无需额外设置
    "SSH_AUTH_SOCK": "/run/user/1000/keyring/ssh"
  },
  "go.useLanguageServer": true,
  "go.languageServerExperimentalFeatures": {
    "diagnostics": true,
    "completion": true
  }
}

保存后，按Ctrl+Shift+P输入Go: Restart Language Server重启扩展。

其他可行的解决办法 #

1. 使用replace指令指向本地克隆的仓库 #

如果暂时不想配置远程访问，可以在go.mod中添加replace指令，让Go直接使用本地克隆的私有仓库代码：

replace bitbucket.org/my-group/my-private-repo => ../path/to/local/my-private-repo

这样gopls会直接读取本地代码，无需访问远程仓库。注意：这种方式适合本地开发，提交代码时记得不要把replace指令推送到远程仓库（除非团队统一使用）。

2. 检查Bitbucket的权限设置 #

你的错误提示是403 Forbidden，虽然提示说需要write或admin权限，但实际上gopls只需要read权限。去Bitbucket的仓库设置里，确认你的账户（或App Password）拥有仓库的Read权限，并且认证方式正确（比如用SSH密钥而非HTTPS密码）。

3. 清理模块缓存并重载依赖 #

有时候模块缓存会导致异常，运行以下命令清理缓存：

go clean -modcache

然后在项目根目录运行go mod tidy重新拉取依赖，再重启VSCode的Go语言服务器。

4. 使用私有模块代理 #

如果团队有多个私有仓库，可以搭建私有模块代理（比如Gitea、Athens等），让Go工具链通过代理访问私有仓库，这样不需要每个项目单独配置SSH密钥，代理会统一处理认证和拉取逻辑。

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