go version报错或无输出说明Go二进制未加入PATH或未安装成功，需先用which go（Linux/macOS）或where go（Windows）检查路径，若无返回则确认安装选项；若有路径但命令失效，需重启终端或手动添加对应bin目录至PATH。
go version 命令报错或无输出
说明 Go 二进制没进系统 PATH，或者根本没装成功。别急着重装，先查三件事：
- 运行
where go（Windows）或which go（Mac/Linux），看有没有返回路径 - 如果没返回，检查安装时是否勾选了“Add Go to PATH”（Windows MSI 安装器默认勾选，但某些定制安装会跳过）
- 如果返回了路径（比如
C:\Program Files\Go\bin），但go version仍失败，说明该路径没被 shell 加载——重启终端，或手动运行set PATH=%PATH%;C:\Program Files\Go\bin（Windows CMD） /export PATH=$PATH:/usr/local/go/bin（Mac/Linux）
go env GOPATH 显示空或不符合预期
Go 1.16+ 默认启用 module 模式，GOPATH 不再决定项目位置，但它仍影响 go install 工具的安装路径（比如 gopls、dlv）。出问题常见于：
- VSCode 插件提示 “gopls not found”：不是没装，而是装到了错误目录——检查
go env GOPATH输出，然后确认go env GOBIN是否指向$GOPATH/bin；如果不是，运行go env -w GOBIN=$GOPATH/bin - 执行
go install golang.org/x/tools/gopls@latest后命令仍不可用：因为GOBIN路径没加进系统PATH，需手动补上 - Mac 上用 Homebrew 装的 Go，
GOPATH可能是~/go，但 Homebrew 自己的 bin 目录（如/opt/homebrew/bin）和 Go 的bin是两回事，别混
国内拉包超时或 module download failed
这是最典型的网络问题，go get 或 go mod tidy 卡住、报错 module lookup failed 或 timeout，本质是默认代理 https://proxy.golang.org 在国内不可达。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且支持私有模块回退） - 若公司内网有自建代理，换成内部地址，例如
go env -w GOPROXY=http://goproxy.internal.company.com,direct - 临时关闭代理调试用：
go env -w GOPROXY=direct，但仅限小范围验证，不建议长期使用 - 注意
direct必须写在最后，表示“如果代理失败，就直连官方源”，否则模块可能完全无法解析
VSCode 中 Go 插件反复提示“Loading…”或跳转失效
根本原因通常是 gopls 没装好，或装在了插件找不到的地方。
立即学习“go语言免费学习笔记（深入）”；
- 先在终端运行
go install golang.org/x/tools/gopls@latest，确保安装成功（成功后无输出，且gopls version可执行） - 打开 VSCode 设置，搜
go.gopath和go.toolsGopath，两个都填成go env GOPATH的输出值（不是GOROOT） - 如果用了自定义
GOBIN，还要在设置里填go.gopls.path，值为$GOBIN/gopls的绝对路径（比如/Users/xxx/go/bin/gopls） - 改完设置后必须重启 VSCode，热重载不生效
