Go环境配置失败主因是PATH未生效或GOPROXY未设置；需确认安装路径、将$GOROOT/bin加入PATH并source，再执行go env -w GOPROXY=https://goproxy.cn,direct及GONOSUMDB="*.goproxy.cn"。
Go 环境装不起来，八成卡在环境变量或模块代理上，不是版本选错，就是 PATH 没生效。最新稳定版（如 go1.22.x）配好 GOPROXY 和 GO111MODULE=on，90% 的安装问题当场消失。
go version 命令报“command not found”怎么办
这不是 Go 没装好，是 PATH 没导进去。Windows 安装 .msi 时勾选“Add Go to PATH”能自动处理，但 macOS/Linux 必须手动加：
- 确认 Go 安装路径：
/usr/local/go（macOS/Linux 默认）或C:\Go（Windows 默认） - 编辑 shell 配置文件（
~/.zshrc或~/.bash_profile），追加：export PATH=$PATH:/usr/local/go/bin - 执行
source ~/.zshrc（别漏这步，否则新开终端才生效） - 验证：运行
which go，有输出路径才算成功；go version应返回类似go version go1.22.5 darwin/arm64
go env 显示 GOPATH 是空的，是不是配置错了
不是错，是正常现象。Go 1.16+ 默认启用模块模式（GO111MODULE=on），GOPATH 不再强制要求用于项目存放。它现在只影响 go install 安装的二进制位置（比如 gopls），而非源码目录。
- 如果你用
go mod init初始化项目，代码可以放在任意路径，不需要塞进$GOPATH/src - 想查当前
GOPATH实际值？运行go env GOPATH，通常默认是$HOME/go - 除非你维护老项目（依赖
GOPATH工作流），否则不用特意设它；但建议把$GOPATH/bin加进PATH，否则go install的工具找不到
go get 总超时或失败，根本拉不下依赖
国内直连 proxy.golang.org 基本不可用，必须配国内模块代理。别只设 GOPROXY，还得关掉校验（否则某些镜像不认）：
立即学习“go语言免费学习笔记（深入）”；
- 执行：
go env -w GOPROXY=https://goproxy.cn,direct - 同时关闭校验：
go env -w GONOSUMDB="*.goproxy.cn" - 验证是否生效：
go env GOPROXY和go env GONOSUMDB应分别输出对应值 - 如果公司内网有私有代理，把
https://goproxy.cn替换为内部地址，末尾仍保留,direct
VS Code 里写 Go 提示“no tools installed”，点一键安装全失败
这是 VS Code 的 vscode-go 插件在尝试用 go install 下载 goplsdlv 等工具，但没走代理或权限不对。
- 先确保终端里
go install golang.org/x/tools/gopls@latest能成功运行（看是否走GOPROXY） - 如果失败，手动执行上面命令，成功后再重启 VS Code
- 插件设置里检查
go.toolsGopath是否指向$GOPATH（不是GOROOT），且该路径下bin/可写 - 别用管理员权限运行 VS Code —— 它会继承错误的环境变量，普通用户启动即可
真正容易被忽略的是 GONOSUMDB 和 GOBIN 的组合：代理设了但校验没关，照样拉不下包；GOBIN 没加进 PATH，装好的 gopls 就算下载成功也找不到。这两处不动，其他都白搭。
