go install 无法管理多版本Go，需借助gvm或goenv等外部工具实现版本切换与项目级锁定。
go install 不能直接管理多版本，得靠外部工具
Go 官方 go install 只负责构建并安装二进制到 $GOBIN（或 $HOME/go/bin），它不感知、也不切换 Go 版本。你执行 go version 看到的版本，完全取决于当前 $PATH 中哪个 go 在前——也就是说，版本管理本质是「替换 PATH 中的 go 可执行文件路径」。
常见错误是以为 go install golang.org/dl/go1.21.0 就能切版本，其实这只是下载了 go1.21.0 命令行工具（用于下载对应 SDK），它本身不修改环境或软链。
- 真正生效的是
go1.21.0 download下载 SDK 后生成的$GOROOT目录（如~/sdk/go1.21.0） - 你需要手动把该目录下的
bin/go软链到统一位置（比如~/go-current/bin/go），再确保~/go-current/bin在$PATH最前面 - 或者用专用工具自动完成路径切换和软链维护
推荐用 gvm 或 goenv，别手写 shell 切换逻辑
自己写函数改 $GOROOT 和 $PATH 看似简单，但容易出错：比如子 shell 不继承、IDE 终端未重载、go mod 缓存与 GOROOT 不匹配、CGO 环境变量（CC, CXX）没同步等。
gvm（Go Version Manager）和 goenv 是成熟方案，原理一致：下载各版本 SDK 到隔离目录，通过 shims 或 wrapper 动态代理 go 命令，并按项目级或全局配置切换。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
gvm更重，自带gobin管理、支持go get隔离，适合老项目或需要精细控制的场景；安装后执行gvm install go1.20.14→gvm use go1.20.14 -
goenv更轻量，类比pyenv，依赖go-build插件下载源码编译；推荐搭配goenv local 1.22.0按目录生效，避免污染全局 - 两者都要求把其 shims 目录（如
~/.gvm/bin或~/.goenv/shims）放在$PATH最左，否则代理失效
go install golang.org/dl/xxx 是辅助下载器，不是版本管理器
golang.org/dl/go1.21.0 这类命令实际安装的是一个「下载器二进制」，它只做一件事：运行 go1.21.0 download 时，从 golang.org 拉取对应版本的预编译包（Linux/macOS/Windows），解压到 $HOME/sdk/go1.21.0。它不改环境变量，也不注册到任何管理器。
如果你已经用 goenv，就别单独跑这个；如果没装管理器，它只是帮你省去手动 wget + tar 的步骤，后续仍需手动软链 + PATH 调整。
- 错误用法：
go install golang.org/dl/go1.22.0@latest && go1.22.0 download && export GOROOT=$HOME/sdk/go1.22.0—— 这样设了GOROOT但没更新PATH，go命令仍调用旧版本 - 正确衔接：
go1.22.0 download后，用goenv rehash让 shims 识别新版本，再goenv global 1.22.0 - 注意：
go1.22.0下载器本身也依赖当前系统已有的 Go（≥1.17），所以首次安装必须先有基础版本
项目级版本锁定靠 .go-version 文件 + goenv，不是 go.mod
go.mod 里的 go 1.21 只是编译兼容性提示，go build 不会校验或拒绝用 1.22 运行；它不影响 go 命令版本，也不触发自动切换。
真要让团队成员在进入项目目录时自动切到指定 Go 版本，必须配合 goenv 的 .go-version 文件：
- 在项目根目录写入纯文本
.go-version，内容为1.21.13（不带go前缀） - 确保终端启动时已加载
goenv init（通常加在~/.zshrc末尾） - cd 进项目后，
which go应返回~/.goenv/shims/go，且go version输出匹配.go-version - IDE（如 VS Code）需配置终端为 login shell，否则不读
.zshrc，导致内置终端无法自动切换
这一步漏掉，是本地能跑 CI 报错最常见的原因——CI 用的是干净容器，必然依赖显式版本声明，而开发者本地靠记忆或手动切换，根本不可持续。
