homebrew安装go无法直接切换多版本，必须搭配goenv或gvm等专用工具；否则易出现go version与goroot不一致、go build报错等问题，因homebrew默认只维护单个go二进制且不提供版本隔离机制。
Mac 上用 Homebrew 装 Go 是最稳的起点，但仅靠它无法解决多版本共存问题；真正要稳定支撑多个项目，必须搭配 goenv 或 gvm 这类专用工具，否则容易出现 go version 和 GOROOT 不一致、go build 报 go: cannot use go X.Y with go X.Z mod 这类硬错误。
Homebrew 安装 Go 后为什么不能直接切版本
Homebrew 默认只维护一个 go 二进制（通常在 /opt/homebrew/bin/go），每次 brew upgrade go 都会覆盖旧版。它不提供版本隔离机制：
-
brew install go@1.21在当前 Homebrew 中并不存在——Homebrew 官方 tap 不提供旧版 Go 的 formula - 手动下载多个
go压缩包解压到不同路径后，若仅靠修改PATH或软链接切换，极易因 shell 缓存、终端复用或 IDE 缓存导致go version和实际执行的二进制不匹配 - VS Code 的 Go 扩展读取的是启动时的
GOROOT，不是你后来export GOROOT=...的值，重启编辑器前切换无效
goenv 和 gvm 选哪个更稳
两者都能隔离版本，但行为逻辑不同，选错容易踩坑：
-
goenv是纯 PATH 注入型：它把每个 Go 版本装在~/.goenv/versions/1.21.10下，通过 shell 函数动态改PATH指向对应bin目录。优点是轻量、无编译依赖；缺点是依赖 shell 钩子（如eval "$(goenv init -)"），zsh/fish/bash 行为略有差异，且对非交互式 shell（如 CI 脚本）支持弱 -
gvm是环境变量重写型：它会主动设置GOROOT并替换PATH，还自带.gvmrc自动加载。但 macOS M1/M2 上原版gvm编译失败率高（缺少gcc或架构识别错误），需改用社区修复版（如soulteary/gvm）或加--binary参数强制用预编译包 - Windows 用户优先用
g工具：它用 Go 写成，跨平台一致性好，安装后直接g install 1.25.10+g use 1.25.10即可，不依赖 shell 钩子，VS Code 和 PowerShell 全兼容
切换版本时必须同步检查的三个地方
光跑 goenv global 1.21.10 或 gvm use go1.21.10 不够，以下三项必须全部对齐：
- 运行
go version输出的版本号 - 运行
go env GOROOT输出的路径，应指向该版本安装目录（如~/.goenv/versions/1.21.10），而非/usr/local/go - 项目根目录下
go.mod文件首行的go 1.21声明——如果声明是go 1.22，而你强行用1.21.10构建，go build会直接报错退出，不会降级兼容
尤其注意：某些 CI 系统（如 GitHub Actions）默认缓存 GOROOT，即使你在 workflow 中运行 goenv use，也要显式指定 setup-go action 的 go-version 字段，否则本地和线上行为不一致。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
