go升级需重置环境变量、模块缓存、工具链和多项目隔离四方面，否则会出现版本错位、依赖异常、工具报错等问题；必须清理旧goroot、清空modcache、重装gopls等工具，并用goenv实现版本隔离。
旧版本Go升级不是换个二进制包就完事——环境变量、模块缓存、工具链、多项目隔离这四块不重置，很容易出现 go version 显示新版本但 go build 仍走旧编译器、gopls 报错、或 go mod tidy 拉出不兼容依赖等“看似升级实则半残”的情况。
GOROOT 和 PATH 必须彻底重置
很多人只改了 PATH，却没清理旧 GOROOT，导致 go env GOROOT 仍指向 /usr/local/go（旧版），而新安装路径是 ~/go。这种错位会让 go install 写入错误目录，go list -m all 解析依赖时行为异常。
- 先执行
go env GOROOT确认当前值 - 手动删除旧
GOROOT目录（如/usr/local/go）或至少重命名备份 - 把新版解压路径（如
~/go）设为唯一GOROOT，并在 shell 配置中显式导出：export GOROOT=$HOME/go -
PATH只保留$GOROOT/bin，删掉任何硬编码的旧路径（比如/usr/local/go/bin）
go mod cache 和 pkg 目录不能复用
Go 1.20+ 对模块缓存格式做了底层调整，旧版 $GOCACHE 和 $GOPATH/pkg 下的归档包和编译产物在新版里可能被跳过或校验失败，引发 cannot find module providing package 或静默链接旧符号。
- 升级后首次运行前，清空缓存：
go clean -cache -modcache - 不要设置
GOPATH（Go 1.16+ 已弃用），若必须设，请确保它不与GOROOT重叠，且go mod项目不依赖src/目录结构 - 检查
go env GOPATH输出是否为默认值（$HOME/go），如果不是，建议重置为默认，避免干扰模块解析
开发工具链必须按新版 Go 重新安装
gopls、staticcheck、dlv 这些工具不是“向下兼容”的——它们会主动调用当前 GOROOT 下的 src 和 pkg，如果这些目录是旧版，就会出现类型定义缺失、AST 解析失败、断点无法命中等问题。
- 全部卸载旧工具：
rm -f $(go env GOPATH)/bin/gopls $(go env GOPATH)/bin/staticcheck - 用新版 Go 安装：
go install golang.org/x/tools/gopls@latest、go install honnef.co/go/tools/cmd/staticcheck@latest - 验证版本匹配：
gopls version输出应包含 “go version go1.22.x”（以你升级的目标版本为准） - VS Code 用户需重启窗口，让 Go 扩展重新探测
gopls路径
多项目版本隔离要靠 goenv 或 asdf，别信“局部 GOPROXY”
仅靠 GO111MODULE=on 和 go.mod 里的 go 1.19 声明，无法阻止 go run 使用系统全局 Go 版本编译——声明只是 lint 提示，不是运行时约束。
- 开发机务必用
goenv或asdf管理版本：它们通过 shell hook 动态修改GOROOT和PATH，比手动切换可靠得多 - 每个项目根目录下执行
goenv local 1.22.1，该命令会在目录生成.go-version文件，进入目录自动生效 - CI/CD 中禁止用
brew install go——Homebrew 更新滞后，应直接下载官方二进制包并指定绝对路径调用 - 切记：
goenv不影响GOROOT的语义，它只是帮你切换不同版本的GOROOT，所以前面三步清理工作依然必须做
最常被忽略的是 go env -w 设置的持久化环境变量——它会覆盖 shell 配置中的 GOROOT，且不易察觉。升级后第一件事就是运行 go env -w GOROOT="" 清空所有写死的配置，再从 shell 配置中重新加载。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
