必须先确认Go安装来源再卸载：运行which go查路径、go env GOROOT看根目录、echo $PATH | tr ':' '\n' | grep go检多路径；apt/brew/gvm等需对应命令卸载，误删目录会残留环境变量与缓存，导致新Go行为异常。
确认 Go 安装来源再动手
直接删 /usr/local/go 或运行 rm -rf 极大概率留坑。不同安装方式残留位置完全不同：apt 装的得用 sudo apt purge golang-go，brew 装的必须走 brew uninstall go，gvm 管理的得先 gvm list 再 gvm uninstall go1.x。混用卸载方式会导致新装的 Go 读错缓存、代理或构建路径。
先执行这三行快速定位：
-
which go—— 看二进制在哪（比如/usr/local/go/bin/go） -
go env GOROOT—— 看当前生效根目录（可能和which go上级不一致） -
echo $PATH | tr ':' '\n' | grep go—— 检查是否多个 go 路径共存（如/usr/local/go/bin和~/go/bin同时在）
清理 shell 配置与环境变量
就算删了二进制，只要 $GOROOT 还指向旧路径，新 Go 就会从错误位置加载标准库、缓存或构建输出——这会导致 go build 失败、go mod download 拉错校验、甚至 go env 显示矛盾值。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 临时清空当前会话变量：
unset GOROOT GOPATH GOHOME - 搜索并编辑所有 shell 初始化文件：
~/.bashrc、~/.zshrc、~/.profile、/etc/profile，删掉含GOROOT=、GOPATH=、export PATH=.*go的整行 - 改完后必须重启终端或执行
source ~/.zshrc（别信“改了就生效”） - 验证：
go env GOROOT应返回自动探测路径（如/usr/local/go），不是你手动设过的旧值
删除模块缓存与构建产物
go mod tidy 不动磁盘文件，go clean -modcache 才是清物理缓存的命令——但它只删 $GOPATH/pkg/mod 目录，不会碰 vendor/ 或构建产物。
立即学习“go语言免费学习笔记（深入）”；
- 先确认当前
GOPATH：go env GOPATH（通常为$HOME/go） - 彻底清模块缓存：
rm -rf $(go env GOPATH)/pkg/mod（注意：全量清空，非选择性） - 清构建缓存：
go clean -cache -modcache -i（-i同时删go install生成的命令，避免它继续调用旧二进制） - 检查
GOSUMDB是否被设为私有地址或off；重装后建议恢复默认：go env -w GOSUMDB=sum.golang.org
验证是否真正干净
装完新 Go 后，光看 go version 不够——得确认它不偷偷加载旧逻辑。常见翻车点是 IDE（如 VS Code）或终端复用工具（如 tmux）缓存旧环境变量，改完配置没重启终端，go env 看起来正常，实际仍走老路径。
- 运行
go env -w GOROOT=""后再go env GOROOT，应返回自动探测路径，而非手动设置值 - 执行
go list -m all | head -5，输出应无报错且版本号符合预期 - 跑一次
go build .（哪怕空项目），观察是否触发完整模块拉取（而非秒过），说明缓存已清空 - 特别注意：某些 CI 流水线或 Makefile 里硬编码了
GOROOT，本地干净不代表 pipeline 干净
