go env才是Go工具链最终采纳的配置值，需重点核对GOROOT（必须指向安装根目录）、GOPATH（影响go install路径）及GOPROXY（国内必配以避免超时），并验证GO111MODULE=on和标准库完整性。
Go 环境不是装完 go version 显示版本就完事了——真正卡住人的，是 GOPROXY 配置失败导致模块拉不下来、GOROOT 和 GOPATH 混用引发的 go build 找不到包、VS Code 插件反复提示 “Loading…” 却不补全。这些都不是“没装好”，而是环境变量和模块机制没对齐。
go version 能跑 ≠ go mod 能用
很多用户执行 go version 成功后就以为万事大吉，结果一运行 go run main.go 就报 cannot find module providing package fmt 或直接卡在 go get。这是因为 Go 1.16+ 默认启用模块模式（GO111MODULE=on），但若本地没有 go.mod 文件且不在 GOPATH/src 下，Go 会拒绝解析标准库以外的依赖。
- 确认模块状态：运行
go env GO111MODULE，输出必须是on；如果不是，执行go env -w GO111MODULE=on - 新建项目务必先初始化：在项目根目录运行
go mod init example.com/myapp，否则import语句可能被误判为旧式 GOPATH 引用 - 不要把项目放在
$GOPATH/src下再用模块——这是双模混用，极易触发路径冲突和缓存错乱
国内用户必设 GOPROXY，否则 90% 的 go get 会超时
官方代理 https://proxy.golang.org 在国内基本不可达，不配代理的话，go get、go install 甚至 gopls 启动都会卡死或报 timeout 错误，现象是终端光标一直闪烁、无任何输出。
- 推荐组合代理（兼顾速度与兜底）：
go env -w GOPROXY=https://goproxy.cn,direct - 如需企业内网镜像，可替换为类似
https://repo.yyrd.com/artifactory/aliyun-golang/，但末尾必须保留,direct，否则私有模块无法拉取 - 验证代理是否生效：运行
go list -m -u github.com/go-delve/delve，能快速返回版本号即成功；若卡顿 >10 秒，说明代理未生效或网络不通
VS Code 的 “Loading…” 不是插件问题，而是 GOPATH/GOROOT 路径错位
vscode-go 插件启动时显示 “Loading…” 长时间不动，90% 是因为插件找不到 gopls 或读取了错误的 GOPATH。它不会报红错，只静默挂起，让人误以为插件坏了。
立即学习“go语言免费学习笔记（深入）”；
- 先手动安装语言服务器：
go install golang.org/x/tools/gopls@latest，确保生成的二进制在$PATH中（通常落在$GOPATH/bin或$GOROOT/bin） - VS Code 设置里搜
go.gopath，填入真实GOPATH值（用go env GOPATH查）；同时检查go.goroot是否指向GOROOT（不是/usr/local/go这种默认路径，而是go env GOROOT输出的实际值） - 关闭所有文件夹，重启 VS Code，再打开项目根目录（含
go.mod），不要打开子目录或单个.go文件——插件需要识别模块根才能加载
Linux/macOS 下 PATH 写错一个斜杠，go 命令就失效
在 ~/.bashrc 或 ~/.zshrc 里写 export PATH=$PATH:/usr/local/go/bin 看似没问题，但如果实际安装路径是 /opt/go 或解压到了 ~/go，而你又没改对应路径，go 命令就会彻底消失——此时 which go 返回空，go version 报 “command not found”。
- 永远用
go env GOROOT获取真实路径，然后拼接：export PATH=$PATH:$(go env GOROOT)/bin - 别硬编码
/usr/local/go，Mac M1/M2 用户常见安装路径是/opt/homebrew/opt/go/libexec，Linux 用tar解压的可能是/home/user/go - 改完配置后必须
source ~/.zshrc（macOS Catalina+ 默认 shell 是 zsh）或source ~/.bashrc，否则新开终端仍读旧 PATH
最常被忽略的是：Go 环境不是静态快照，而是 go env 输出的一组动态变量组合。每次 go install、go run、编辑器补全，都在实时读取这些值。只要其中任意一个（尤其是 GOPROXY、GO111MODULE、GOPATH）和当前操作场景不匹配，问题就会以不同形式浮现——它不报错，只沉默或卡住。
