VSCode中Go环境问题八成源于GOPROXY未生效、GOBIN不可写或未在PATH、项目未在module根目录打开；需验证go version≥1.21、手动配置GOPROXY、确保GOBIN在PATH、安装gopls和dlv并正确设置launch.json。
gopls 启不起来、dlv 找不到、跳转失效、断点不命中——这些问题八成不是插件没装，而是 GOPROXY 没生效、GOBIN 不在 PATH、或者 VSCode 打开的压根就不是模块根目录。
go version 和 GOPROXY 必须先验证好
VSCode 的 Go 插件启动时会调用系统 go 命令。如果 go version 报错或低于 1.21，gopls 可能根本不会加载；而所有工具（尤其是 dlv、gopls）下载失败的头号原因，是 GOPROXY 没写进环境。
- 终端里运行
go version，确认输出类似go version go1.22.5 darwin/arm64 - 若报
command not found，先检查GOROOT和PATH是否包含/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows） - 运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐），再执行go env GOPROXY确认已写入 -
GO111MODULE=on不解决代理问题，别信它能绕过网络限制
gopls 不显示 running？检查 GOBIN 和权限
gopls 默认安装到 $GOBIN，而 VSCode 要能调用它，必须满足：路径存在、当前用户可写、且该路径在系统 PATH 中。否则状态栏卡在 “Loading…” 或反复崩溃。
- 运行
go env GOBIN，若为空，手动设为$GOPATH/bin：go env -w GOBIN=$GOPATH/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - 确认
$GOBIN已加入PATH：重启终端后执行echo $PATH（或path），看是否含该路径 - 手动触发安装：
go install golang.org/x/tools/gopls@latest，然后重启 VSCode
F5 调试失败：could not find Delve
VSCode 默认用 dlv 调试，但它不会自动把 dlv 加入 PATH，也不会帮你建 .vscode/launch.json。报这个错，说明路径没打通，或者配置没对上。
- 先装
dlv：go install github.com/go-delve/delve/cmd/dlv@latest，完成后检查$GOBIN/dlv是否存在 - 确保当前打开的文件夹是 Go module 根目录（即含
go.mod的目录） - 在项目根目录下创建
.vscode/launch.json，最简配置至少包含：{ "version": "0.2.0", "configurations": [ { "name": "Launch", "type": "go", "request": "launch", "mode": "exec", "program": "${workspaceFolder}/main.go" } ] }
右下角不显示 gopls (running)？别只信自动安装
VSCode 的 Go 扩展有时会静默降级为只读模式，尤其在缓存损坏、workspace 配置错乱、或用了 replace/go.work 却没正确打开根目录时。
立即学习“go语言免费学习笔记（深入）”；
- 按
Ctrl+Shift+P（或Cmd+Shift+P），运行Go: Install/Update Tools，勾选gopls强制重装 - 如果项目有
go.work，务必用File > Open Folder打开的是该文件所在目录，而不是子模块 - 跳转失败时，先看右下角状态栏是否显示
gopls (initializing)；卡住就删缓存：
macOS：删掉$HOME/Library/Caches/gopls
Windows：删掉%LOCALAPPDATA%\gopls
PATH，但 VSCode 启动方式绕过了它。这点最容易被忽略。 
