VSCode中安装gopls失败求助：终端安装也无法成功

DevOps 小满

2026-7-10

解决VSCode中Go语言gopls工具安装失败问题

问题描述

刚学习Go语言，在VSCode中安装gopls工具失败，终端直接安装也无法成功，安装日志如下：

Tools environment: GOPATH=/Users/maxgod/go
Installing 1 tool at /Users/maxgod/go/bin in module mode.
  gopls

Installing golang.org/x/tools/gopls@latest FAILED
{
 "code": 1,
 "killed": false,
 "signal": null,
 "cmd": "/usr/local/go/bin/go install -v golang.org/x/tools/gopls@latest",
 "stdout": "",
 "stderr": "runtime/cgo
# runtime/cgo
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
"
}

1 tools failed to install.

gopls: failed to install gopls(golang.org/x/tools/gopls@latest): Error: Command failed: /usr/local/go/bin/go install -v golang.org/x/tools/gopls@latest
runtime/cgo
# runtime/cgo
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

错误根源

日志中反复出现的xcrun错误，说明Mac系统的Xcode Command Line Tools未安装或路径无效。gopls编译依赖cgo，而cgo需要系统提供的编译工具链，缺失该工具链会直接导致编译失败，与Go语言的GOPATH、模块配置无关。

修复步骤

安装Xcode Command Line Tools
打开终端执行以下命令，按照系统弹窗提示完成安装：
```
xcode-select --install
```
重置工具路径（若安装后仍报错）
如果安装后依旧提示路径错误，执行命令重置默认工具路径：
```
sudo xcode-select --reset
```
验证修复
执行以下命令，能正常输出版本信息即说明修复成功：
```
xcrun --version
```
重新安装gopls
系统工具链修复后，在终端执行安装命令：
```
go install golang.org/x/tools/gopls@latest
```
VSCode生效
重启VSCode或Go语言插件，即可正常使用gopls的代码提示、重构等功能。