g是轻量跨平台Go多版本管理工具，通过独立安装目录和软链接管理版本，避免修改GOROOT，支持一键安装、秒级切换及项目级自动绑定。
go 多版本共存本身不难，难的是切换时不出错、不污染环境、不干扰 IDE 和构建流程。最稳妥的路径不是“装多个再手动切”，而是用轻量工具统一管理安装路径和 PATH，避免碰 GOROOT。
为什么别碰 GOROOT？
新版 go（1.16+）已默认忽略 GOROOT，靠自身路径定位标准库；设了反而容易和多版本逻辑冲突，尤其在 CI 或 VS Code 中触发奇怪的 cannot find package 错误。实测中 90% 的“版本切换后 go mod download 失败”都源于残留的 GOROOT 干扰。
g 工具：Linux/macOS/Windows 通用的最小依赖方案
它不改系统级环境变量，不依赖 shell hook，只管安装目录和软链接，适合从 CI 到本地开发的全链路一致性。
- 安装：
go install github.com/stefanberger/g@latest，确保$GOPATH/bin在PATH前置位置 - 查可用版本：
g list-remote（注意：部分旧版如go1.17需加--all） - 装两个常用版本：
g install 1.21.6和g install 1.22.3 - 切换：
g use 1.22.3→ 立即生效，go version输出匹配，which go指向~/.g/go_versions/1.22.3/bin/go - 项目级绑定：在项目根目录写
.gorc，内容仅一行1.21.6，再在~/.zshrc加自动加载钩子（官方文档有 3 行 shell 函数）
Windows 批处理切换：不装任何工具也能稳
Windows 没有原生软链接或 shell 别名，但 setx 写入用户 PATH 是可靠方案，关键点在于顺序和隔离。
- 每个版本解压到独立路径，例如：
C:\go1.21、C:\go1.22，绝不覆盖C:\Go - 批处理脚本里只做两件事：清空旧 Go 路径（用
reg query+reg add更安全）、把目标bin置顶，例如：setx PATH "C:\go1.22\bin;%PATH%" - VS Code / GoLand 必须重启才能读取新
PATH，否则仍用旧go；可配合go.toolsEnvVars设置临时GOPATH避免缓存干扰 - 临时切换用
set PATH=C:\go1.21\bin;%PATH%，关掉 CMD 就还原，适合快速验证
go.mod 的 go 指令不是锁版本，别被它误导
go 1.22 在 go.mod 里只是声明最低兼容版本，go build 允许用更高版本（如 go1.23）构建，但不允许更低（go1.21 构建含 go 1.22 的模块会报错）。真正卡死版本的是构建约束或第三方依赖的 //go:build 标签，不是 go.mod 本身。
立即学习“go语言免费学习笔记（深入）”；
所以切换前先看 go.mod 里的 go 行，再决定是否要 g use 到对应版本——而不是反过来。
