运行 go version 和 go env GOROOT 确认版本与路径一致，再检查 go.mod 中的 go directive 是否更新为 1.25，并同步 IDE、CI 及间接依赖配置。
怎么确认当前 Go 版本并判断是否真需要升级
别急着下载安装包，先运行 go version 看清楚你用的是不是 go1.25——这是截至 2026 年 3 月的最新稳定版。如果输出是 go1.23.5 或更早，说明确实该升了；但如果已经是 go1.25，那所谓“升级”大概率只是误操作。
-
go version只显示二进制版本，不反映GOROOT设置是否生效 - macOS 和 Windows 上双击
.pkg或.msi安装程序，默认不会覆盖/usr/local/go或C:\Go，而是静默装到新路径，终端仍调用旧版 - 真正有效的判断方式是：同时运行
go version和go env GOROOT，两者输出的路径必须一致且指向新安装目录
手动覆盖安装时必须清理旧路径并重设 GOROOT
Go 没有内置升级命令，官方推荐方式就是下载 tar.gz / .zip 包，解压覆盖。但直接解压不清理旧版，会导致 go 命令行为不一致——比如 go build 用新版，go test 却因缓存或环境变量残留调用旧版。
- 先备份旧版：
sudo mv /usr/local/go /usr/local/go.1.23.5 - 再解压新包：
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz -
GOROOT必须显式设为/usr/local/go（不能是/usr/local/go/bin），否则go env GOROOT会返回空或错误路径 - 在
~/.zshrc或~/.bashrc中追加：export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc
为什么 go version 显示对了，项目却编译失败
常见假成功现象：终端里 go version 输出 go1.25，但运行 go test 报 cannot use ~string (invalid type) ——这说明 Go 编译器主动降级了，根源在 go.mod 文件里的 go directive 还是旧的。
-
go.mod开头的go 1.23是硬性约束，即使你装了go1.25，只要没改这行，模块就按 1.23 兼容模式解析语法和标准库 - 必须手动编辑
go.mod，把go 1.23改成go 1.25，再执行go mod tidy - 改完后跑一次
go list -m -json | jq '.Go'确认实际生效的 Go 版本
IDE 和 CI 环境容易漏掉的三处生效点
本地终端能用 ≠ 项目真正升级完成。很多问题出在工具链没同步，尤其是 IDE 和持续集成环境。
立即学习“go语言免费学习笔记（深入）”；
- GoLand：Settings → Go → GOROOT 必须手动选中
/usr/local/go，不能依赖自动探测 - VS Code：检查设置里
"go.goroot"是否为空，为空则读系统GOROOT；若设了值，需手动更新 - CI 脚本（如 GitHub Actions）：不能只写
setup-go@v4，要明确指定go-version: '1.25'，否则可能复用缓存的旧版
最常被忽略的是：改完 go.mod 后没验证间接依赖是否兼容。比如 golang.org/x/net 在 1.25 下默认启用 http2 的 strict mode，老代码里没设超时可能卡死——这类变化不会报错，但会在运行时暴露。
