Go环境搭建失败主因是GOPATH、GO111MODULE或插件依赖安装不当；VSCode无提示、跳转失效、调试失败，多因gopls未正确安装或路径识别不准，需验证go env GOROOT、GOPATH、GO111MODULE三值并确保GO111MODULE=on、gopls和dlv安装路径被VSCode识别。
Go 环境搭不起来，八成卡在 GOPATH、GO111MODULE 或插件依赖安装这三步上；VSCode 里写 go 文件没提示、跳转失效、调试起不来，基本是 gopls 没装对或路径没识别准。
确认 Go 安装后，必须验证的三个命令输出
别只看 go version 能跑就以为完事。真正影响后续开发的是这三个：
-
go env GOROOT—— 输出应为实际安装路径（如C:\Go或/usr/local/go），不能是空或错位路径 -
go env GOPATH—— Go 1.16+ 默认启用模块模式，GOPATH只影响go install生成的二进制存放位置，但 VSCode 的 Go 插件仍会读它；若你手动设过，确保目录存在且有读写权限 -
go env GO111MODULE—— 必须是on（不是auto或空），否则gopls启动时可能 fallback 到旧式 GOPATH 模式，导致项目内无法正确解析依赖
VSCode 安装 Go 插件后，gopls 安装失败的典型现象与修复
打开 .go 文件时右下角弹出 “Failed to install tools” 或 “gopls is not available”，常见原因不是网络问题，而是执行权限或模块代理冲突。
- 先手动运行：
go install golang.org/x/tools/gopls@latest，观察是否报cannot find module providing package—— 这说明当前 shell 没启用模块模式，临时补一句：GO111MODULE=on go install golang.org/x/tools/gopls@latest - 国内用户大概率遇到
proxy.golang.org超时，不要只改临时环境变量，直接永久设置：go env -w GOPROXY=https://goproxy.cn,direct - VSCode 内置终端可能未继承系统环境变量，重启 VSCode（不是 reload window）再试；或者在 VSCode 设置里搜
go.toolsEnvVars，手动加一条："GO111MODULE": "on"
Windows 下 PATH 配置错位导致 dlv 调试器找不到
装完 dlv 后，VSCode 点调试按钮报错 Could not launch process: fork/exec ... dlv.exe: The system cannot find the file specified，本质是 VSCode 没找到 dlv 可执行文件。
立即学习“go语言免费学习笔记（深入）”；
-
go install github.com/go-delve/delve/cmd/dlv@latest执行后，二进制默认生成在$GOPATH/bin（不是$GOROOT/bin） - 检查
$GOPATH/bin是否已加入系统PATH：Win+r →sysdm.cpl→ “环境变量” → 查看 “系统变量” 中的Path是否包含该路径（如C:\Users\XXX\go\bin） - 改完 PATH 后，务必关闭所有 CMD/PowerShell/VSCode 窗口，重新打开终端执行
dlv version确认可调用，再启动 VSCode
最常被忽略的一点：VSCode 的 Go 扩展会尝试自动下载工具，但它默认用的是当前打开文件夹的 go 命令 —— 如果你同时装了多个 Go 版本（比如通过 asdf 或 gvm），而项目根目录下又没有 go.mod，gopls 可能静默降级使用错误版本的 stdlib，导致类型推导异常。动手前，先 cd 到项目目录，敲一遍 go version 和 go list -m 确认上下文干净。
