go运行时不能单独升级，必须整体升级go工具链；需删除旧goroot、解压新安装包、更新path和环境变量，并同步ci、docker及ide配置，确保全链路一致。
Go 运行时（runtime）版本由 Go 工具链本身决定，不能单独升级——它和 go 命令、GOROOT、标准库完全绑定。你真正要升级的，是整个 Go 安装（即 go 二进制及其附带的 runtime），而不是“依赖”它。
为什么不能只升级 runtime
Go 的 runtime 不是独立包，也不在 go.mod 中声明。它是编译器和链接器在构建时硬编码进二进制的，和 go 版本严格对应。比如：
-
go1.24编译出的程序，必定使用runtimev1.24，哪怕你本地有go1.23的源码也无用 -
go version -m ./mybinary会显示go1.24，这个信息来自二进制头，不可后期替换 - 试图用
go get golang.org/runtime会失败——该路径根本不存在，runtime不是可导入模块
升级 runtime 的唯一方式：升级 go 工具链
所有平台统一逻辑：换掉 /usr/local/go（或你的 GOROOT），重装新版本 go 二进制。关键动作包括：
- 删除旧
GOROOT目录：sudo rm -rf /usr/local/go（Linux/macOS）或卸载 .msi/.pkg（Windows） - 从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载匹配系统的包，例如
go1.25.linux-amd64.tar.gz - 解压到原位置：
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz - 确认
PATH指向新bin：export PATH=/usr/local/go/bin:$PATH（写入~/.zshrc或~/.bashrc） - 验证：
go version必须输出go1.25，且go env GOROOT指向新路径
多项目/CI 场景下容易漏掉的点
仅更新本地 go 命令远远不够。以下位置若未同步，会导致构建产物仍用旧 runtime：
-
.github/workflows/*.yaml中的go-version: 1.24.x必须改为1.25.x - Dockerfile 中的
FROM golang:1.24必须升级为golang:1.25 -
.devcontainer/devcontainer.json的image字段需更新基础镜像 - CI 配置如
.circleci/config.yml中的cimg/go:1.24.0同样要改 - 如果你用
promu构建 Thanos 类项目，.promu.yml的go: version也得改
runtime 升级不是改一行代码的事——它是一次工具链、CI、容器、开发环境的全链路对齐。任何一处遗漏，都可能让某个构建环节悄悄回退到旧版本，而你却只在本地 go version 看到新版本，误以为已生效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
