Go 环境损坏需彻底清理残留：删 SDK、GOPATH、GOCACHE 及环境变量，重装官方版并设 GOPROXY=https://mirrors.aliyun.com/goproxy/,direct。
Go 环境损坏的典型表现
执行 go version 报错 command not found，或提示 cannot find module providing package；go mod download 卡住、返回 403 或 checksum mismatch；go build 突然报出大量 undefined: sync.Pool 类似底层类型缺失——这些不是代码问题，而是 GOPATH、GOMODCACHE 或 SDK 二进制本身已处于不一致状态。
彻底清理旧 Go 安装（含残留配置）
别只删 /usr/local/go 或 ~/go。macOS/Linux 下需手动清除：
-
rm -rf /usr/local/go（若用 pkg 安装）或rm -rf ~/go/sdk/go*（若用go install管理多版本） -
rm -rf $HOME/go/bin和$HOME/go/pkg（GOPATH默认值，即使启用了 module 仍可能被缓存 工具 读取） -
rm -rf $GOCACHE（默认为$HOME/Library/Caches/go-build或$HOME/.cache/go-build），否则go build可能复用损坏的中间对象 - 检查
~/.zshrc、~/.bash_profile或/etc/profile，删掉所有含export GOROOT=、export GOPATH=、PATH=……:$GOROOT/bin的行——Go 1.16+ 已无需显式设GOPATH，硬 编码 反而导致冲突
重新安装并验证最小可用环境
从官网下载对应平台的最新稳定版 .tar.gz（不推荐用 Homebrew 或 apt，它们常滞后且混用 go 与 golang 包名造成路径污染）：
curl -OL https://go.dev/dl/go1.22.5.darwin-arm64.tar.gz sudo rm -rf /usr/local/go sudo tar -C /usr/local -xzf go1.22.5.darwin-arm64.tar.gz export PATH="/usr/local/go/bin:$PATH"新开终端后验证：
立即学习“go 语言免费学习笔记（深入）”；
-
go version应输出明确版本号，无 warning -
go env GOROOT必须是/usr/local/go（非~/go），go env GOPATH应为$HOME/go（但实际项目中可完全忽略它） -
go mod init example.com/test && go mod download能静默完成，无 checksum 错误
模块缓存与代理设置（国内用户关键步骤）
跳过这步，go get 会卡在 proxy.golang.org 或返回 403。必须在重装后立即设置：
- 运行
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 如需私有模块，追加
GOINSECURE=git.internal.company.com - 禁用校验（仅调试时临时用）：
go env -w GOSUMDB=off，但上线前务必恢复GOSUMDB=sum.golang.org
注意：GOPROXY 值末尾的 ,direct 是 fallback 机制，不可省略；阿里云 镜像域名不含 www，写成 https://www.aliyun.com/goproxy/ 会 404。
真正麻烦的不是重装，是那些没被 go clean -modcache 清掉的 vendor 目录、IDE 缓存（如 Goland 的 system/caches）、以及 go.work 文件里指向已删除 SDK 的绝对路径——这些都得手动翻找删干净，否则新环境一跑就退回到老错误。
