gopls是Go自动补全的唯一可靠来源，必须正确安装、被编辑器识别且项目处于模块上下文中三者缺一不可；需通过go install安装、配置PATH、启用官方Go扩展、确保go.mod存在并以模块根目录打开项目。
gopls 是 Go 自动补全的唯一可靠来源，不是装个插件就能生效——它必须正确安装、被编辑器识别、且项目处于模块上下文中，三者缺一不可。
确认 gopls 已安装并可执行
VS Code 或 GoLand 的补全失效，80% 源于 gopls 根本没跑起来。
- 在终端运行
go install golang.org/x/tools/gopls@latest（注意：不是go get，后者已弃用） - 验证是否成功：
gopls version应输出类似golang.org/x/tools/gopls v0.15.2；若报command not found，说明$GOPATH/bin（或$HOME/go/bin）未加入$PATH - Windows 用户请检查系统环境变量中是否包含
C:\Program Files\Go\bin；macOS/Linux 用户可在~/.zshrc中追加export PATH=$PATH:$(go env GOPATH)/bin
VS Code 必须启用官方 Go 扩展并指向 gopls
别信“Go Extension Pack”或旧版 “Go for Visual Studio Code”，只留一个：golang.go（由 Go Team 维护）。
- 打开命令面板（
Ctrl+Shift+P），输入Go: Install/Update Tools，勾选gopls并安装 - 检查设置中
"go.useLanguageServer": true—— 这是开关，某些旧配置可能被手动关掉 - 禁用所有含
gocode、gogetdoc、godef的插件或配置项，它们与gopls冲突，会导致补全卡顿或提示错乱 - 状态栏右下角应显示
gopls: ready；若卡在initializing或报错，打开输出面板 → 切换到gopls日志查看具体失败原因（常见为GO111MODULE=off或代理超时）
项目必须以 go.mod 根目录方式打开
gopls 不会扫描子目录或单个文件——它只认当前工作区根目录下的 go.mod。
- 没有
go.mod？在项目根目录运行go mod init example.com/myapp（模块名可任意，但需是合法路径格式） - 已有项目但只有
vendor/？先确保go mod vendor成功，再在 VS Code 中打开该目录（不是vendor/github.com/xxx） - 多模块项目？用
go work init+go work use ./module1 ./module2生成go.work，VS Code 会自动识别为 workspace - 打开后看状态栏右下角：应显示
Go (module: example.com/myapp)；若显示Go (GOPATH)或无任何 module 提示，说明没识别到模块
补全仍不完整？检查两个关键配置项
默认配置下，未导入包的方法、跨模块符号、甚至结构体字段都可能不出现——这不是 bug，是 gopls 的保守策略。
立即学习“go语言免费学习笔记（深入）”；
- 启用未导入包补全：
"go.gopls.completeUnimported": true（输入http.时能提示HandleFunc等，即使还没import "net/http"） - 启用占位符参数提示：
"go.gopls.usePlaceholders": true（调用函数时自动填充形参名和括号，按Tab跳转） - 若用
vendor目录，必须设"go.useVendor": true，否则gopls默认忽略所有vendor/下的代码 - 首次打开大型项目时，
gopls需索引依赖，CPU 占用高、补全延迟属正常；等待 10–30 秒，或重启语言服务器（Go: Restart Language Server）
gopls 没看到 go.mod、PATH 里找不到二进制、或者 VS Code 打开的是子目录而非模块根目录——这三个点，比任何插件开关都关键。 
