VSCode中使用Golang遇gopls安装失败及无法连接服务器问题求解决

以下是几个经过验证的解决办法，按顺序尝试即可：

1. 手动安装gopls并指定路径 #

• 先确认Go环境变量配置正常，执行命令：

  go env
  

  检查GOPATH和GOBIN是否有合法取值，若GOBIN为空，可先设置：

  go env -w GOBIN=$GOPATH/bin
  

• 配置国内代理加速安装（若网络访问golang.org受限）：

  go env -w GOPROXY=https://goproxy.cn,direct
  

• 手动安装gopls：

  go install golang.org/x/tools/gopls@latest
  

• 打开VSCode，按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Preferences: Open Settings (JSON)，添加或修改gopls路径配置：

  "go.goplsPath": "/你的GOBIN路径/gopls"
  

  替换为实际的gopls可执行文件路径。

2. 重置Go插件工具安装 #

• 在VSCode打开命令面板，输入Go: Install/Update Tools，勾选gopls以及其他依赖工具（如gopkgs、guru等），点击确定重新安装。
• 若之前安装失败残留异常文件，可先删除GOPATH/pkg/mod下的相关缓存，再执行上述安装操作。

3. 检查Go版本兼容性 #

• gopls要求Go版本≥1.16，执行命令查看当前版本：

  go version
  

  若版本过低，前往Go官网下载安装稳定版（推荐1.21.x系列），安装后重启VSCode。

4. 排查权限与网络问题 #

• Windows用户尝试以管理员身份启动VSCode，避免安装时权限不足；
• macOS/Linux用户检查GOPATH目录权限，执行：

  chmod -R 755 $GOPATH
  

• 确认网络可正常访问代理服务器或golang.org，必要时切换网络环境重试。

5. 重装Go插件 #

• 在VSCode扩展面板找到Go插件，点击卸载，重启VSCode后重新安装最新版本的Go插件，再尝试安装gopls。

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