VSCode中Go补全跳转失效的根本原因是gopls未正确安装或未识别Go模块；需执行go install golang.org/x/tools/gopls@latest、确认which/where gopls路径有效、在含go.mod的项目根目录打开工作区，并确保"go.useLanguageServer": true。
VSCode 里 Go 补全失效、跳转点不动、fmt. 按了没反应——不是插件装错了，而是 gopls 没就位，或者它根本不知道你当前打开的是个 Go 模块。
确认 gopls 已安装且路径可被 VSCode 找到
gopls 是补全和跳转的真正引擎，VSCode 的 Go 插件只是它的“遥控器”。装了插件不等于 gopls 就在运行。
- 在终端执行
go install golang.org/x/tools/gopls@latest（注意：不是go get，后者已弃用） - 安装完成后，运行
which gopls（macOS/Linux）或where gopls（Windows），确认返回有效路径，比如/Users/you/go/bin/gopls - 打开 VSCode 设置（
Cmd+Shift+P→Preferences: Open Settings (JSON)），检查是否有"go.gopls.path"配置项；如果没有，加上它并填入上一步得到的绝对路径；如果有但指向错误（比如旧版gopls或空值），请修正 - 确保该路径所在目录（如
$GOPATH/bin）已加入系统PATH，否则 VSCode 内置终端可能找不到gopls
必须让 gopls 知道你在开发一个模块
没有 go.mod，gopls 默认退化为 GOPATH 模式，第三方包和项目内代码基本不索引，补全只剩标准库。
- 在项目根目录下运行
go mod init example.com/myapp（模块名合法即可，不一定要发布） - 如果已有依赖，再运行
go mod tidy，生成完整go.mod和go.sum - VSCode 必须以这个含
go.mod的目录为工作区打开（不能只打开子文件夹或单个.go文件） - 若项目使用
vendor/，不推荐；如必须用，请额外设置go env -w GOFLAGS="-mod=vendor"，但优先迁移到模块模式
检查 VSCode 设置是否启用语言服务器
即使 gopls 装好了、go.mod 也有了，VSCode 仍可能“假装没看见”。
立即学习“go语言免费学习笔记（深入）”；
- 在
settings.json中确认存在"go.useLanguageServer": true（默认是true，但某些旧配置或迁移后可能被覆盖） - 禁用所有干扰插件，特别是旧版
Go Nightly、vscode-go（非官方）、或其他 LSP 客户端（如rust-analyzer），它们会抢占进程或冲突 - 首次打开
.go文件后，右下角状态栏应显示gopls正在加载；若长时间卡在Loading...，打开命令面板运行Go: Restart Language Server - 想快速验证：在函数体内输入
fmt.，看是否立刻弹出Println、Errorf等；光标停在Println上按Ctrl+Click，应能跳转到定义
补全卡顿、CPU 占满、频繁崩溃怎么办
这不是配置失败，而是 gopls 在索引时过载。尤其当你把整个 $GOPATH/src 当工作区打开，或项目含大量 vendor/ 代码时。
- 只打开单个模块目录，不要打开父级
src/或goprojects/ - 在
settings.json的"gopls"对象里添加限制："build.experimentalWorkspaceModule": true（v0.13+ 推荐，对多模块项目更稳） - 关闭非必要分析：
"analyses": {"composites": false, "shadow": false}，减少后台计算压力 - 避免在
vendor/目录内直接编辑——gopls会尝试索引全部 vendored 代码，极易超时或 OOM
最常被忽略的一点：补全是否生效，跟插件数量无关，只取决于 gopls 是否运行、是否识别模块、是否被其他扩展劫持。别急着装新插件，先看 Output 面板里的 gopls (server) 日志，那里写的才是真实原因。
