必须彻底清理旧版再安装新版本，包括删除/usr/local/go、清理PATH中旧路径、验证go.mod依赖兼容性，否则go build或go mod tidy可能失败。
直接换掉 /usr/local/go 目录就行，但必须同步清理旧二进制残留、重置 PATH、验证模块兼容性——跳过任意一步都可能让 go build 突然失败或 go mod tidy 拉错依赖。
删干净再装，别信“覆盖安装”
Go 官方不支持就地覆盖升级，/usr/local/go 里残留的旧 bin/go 或 pkg 可能被新 shell 误读。Mac/Linux 必须手动清空：
sudo rm -rf /usr/local/go- 检查
$PATH是否还包含旧路径（比如/usr/local/go-1.20/bin），删掉对应行 - Windows 用户要删
C:\Go并清空系统环境变量里的旧条目
装新包时用 tar -C /usr/local -xzf go*.tar.gz，解压后 go version 输出必须和下载包版本一致，不能是缓存的旧值。
go mod tidy 不是万能的，得看 go.sum 锁定的版本
升级 Go 后运行 go mod tidy，它会按新 Go 版本的模块解析规则重新计算依赖树——但 go.sum 里锁死的哈希值可能和新版不匹配，导致 go build 报 checksum mismatch。
立即学习“go语言免费学习笔记（深入）”；
- 先执行
go mod verify确认校验和是否全部通过 - 若失败，不是删
go.sum重来，而是用go get -u逐个升级有冲突的依赖（比如google.golang.org/protobuf在 Go 1.22+ 需 v1.32+） - 特别注意
golang.org/x/系列库，它们常随 Go 版本迭代强制升级
随机数、反射、proto 接口这些地方最容易崩
Go 1.21+ 默认启用 math/rand/v2，1.22+ 强制要求显式接口实现，protobuf-go v1.30+ 废弃 XXX_ 方法——这些变更不会报语法错误，但运行时 panic 或静默失效：
- 搜代码里所有
import "math/rand"，替换成import "math/rand/v2"，并把rand.Intn()改成rand.N().Intn() - 查
proto.Message类型参数，换成protoreflect.Message；所有msg.XXX_MessageName()改成msg.ProtoReflect().Descriptor().FullName() - 跑一遍
go test -race，Go 1.22 的竞态检测器更敏感，旧版没暴露的 data race 会立刻浮现
真正卡住人的从来不是安装步骤，而是 go.mod 里一个没更新的间接依赖拖垮整个构建链——建议升级前先用 go list -m all | grep -E "(protobuf|certmagic|mysql)" 锁定关键第三方库版本，挨个确认其最新版是否适配目标 Go 版本。
