VSCode中Go智能提示与自动补全失效问题求助

我在Mac上安装了Go语言，VSCode中已安装官方Go扩展，但自动补全功能无法使用。

打开Go项目文件夹时，终端输出如下：

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

Installing golang.org/x/tools/gopls@v0.14.1 (/Users/drexter/go/bin/gopls) SUCCEEDED

All tools successfully installed. You are ready to Go. :)

执行which go命令返回/usr/local/go/bin/go。

我之前未设置GOROOT环境变量，于是在终端中执行export GOROOT=/Users/drexter/go/bin进行设置。

执行printenv命令显示：

...
GOPATH=/Users/drexter/go
GOROOT=/Users/drexter/go/bin
...

VSCode的settings.json配置如下：

"go.languageServerFlags": [
],
"go.toolsManagement.autoUpdate": true,
"editor.tabCompletion": "on",
"go.installDependenciesWhenBuilding": true,
"go.formatTool": "gofmt",
"go.gopath": "~/go",
"go.useLanguageServer": true,
"gopls": {
  // Add parameter placeholders when completing a function.
 "usePlaceholders": true,

 // If true, enable additional analyses with staticcheck.
 // Warning: This will significantly increase memory usage.
 "staticcheck": false,
},
"go.lintTool": "golangci-lint",
"go.delveConfig": {
},
// "go.goroot": "~go/bin",
"editor.fontSize": 14,
"[go]": {
  "editor.insertSpaces": false,
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.organizeImports": true
  }
}

我还尝试卸载并重装Go扩展，以及使用Go Nightly扩展，但均未解决问题。

请问如何让Go语言的自动补全功能正常工作？

1. 修正GOROOT环境变量 #

你的GOROOT设置错误，正确的GOROOT是Go的安装根目录，而非bin目录。根据which go返回的路径，正确值应为/usr/local/go：

• 终端临时生效执行：

  export GOROOT=/usr/local/go
  

• 永久生效需编辑shell配置文件（如~/.zshrc或~/.bash_profile），添加：

  export GOROOT=/usr/local/go
  export PATH=$GOROOT/bin:$PATH
  

• 执行source ~/.zshrc（对应你的shell配置文件）使配置生效，验证：

  go env GOROOT
  

  应返回/usr/local/go。

2. 修正VSCode中的GOROOT配置 #

打开VSCode的settings.json，取消注释并修正go.goroot配置：

"go.goroot": "/usr/local/go"

3. 重启VSCode并重置gopls #

• 完全关闭VSCode后重新打开
• 打开Go项目，等待gopls重新加载；或按Cmd+Shift+P执行Go: Install/Update Tools，确保所有工具正常安装

4. 检查项目模块配置 #

确保项目根目录存在go.mod文件（Go Modules模式），若没有则执行：

go mod init <你的项目模块名>

gopls依赖Go Modules提供精准的代码补全支持。

5. 排查gopls日志 #

按Cmd+Shift+P执行Go: Open Language Server Log，查看是否有报错信息，根据提示进一步定位问题。

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