gvm已归档，不建议新环境使用；当前最稳妥的方案是用g或asdf管理Go版本，因gvm自2017年停更，存在TLS连接失败、PATH注入失效及GOROOT冲突等问题。
gvm 已归档，不建议新环境使用；当前最稳妥的方案是用 g 或 asdf 管理 Go 版本。
为什么 gvm 不再可靠
gvm 的 GitHub 仓库自 2017 年起已标记为 archived，不再接收修复或更新。在 macOS Monterey 及更新系统、Apple Silicon（M1/M2/M3）、较新 Linux 发行版（如 Debian 12）上，常见问题包括：
-
curl: (35) SSL connect error：硬编码旧 TLS 版本，无法连接dl.google.com -
gvm use go1.21.6 --default后go version仍显示旧版本：PATH 注入失败，~/.gvm/scripts/gvm未被正确 source - 与
brew install go冲突，导致GOROOT混乱、go build报undefined symbol等静默错误
推荐替代方案：用 g 工具切换
g 是目前最轻量、最贴近 Go 原生体验的多版本管理器，由 voidint 维护，支持自动镜像加速（G_MIRROR=https://golang.google.cn/dl/），且不依赖 shell 初始化脚本、不污染 PATH。
- 安装：
curl -sSL https://raw.githubusercontent.com/voidint/g/master/install.sh | sh，确保$HOME/bin在PATH前置位置 - 列出可用版本：
g list（从https://go.dev/dl/实时抓取） - 安装并切换：
g install 1.21.6→ 自动下载、解压、软链到$HOME/.g/versions/1.21.6，再将$HOME/.g/current指向它 - 验证：
go version应输出匹配版本；which go应指向$HOME/.g/current/bin/go -
关键提醒：务必
unset GOROOT并从 shell 配置中删除所有export GOROOT=...行；GOBIN也应保持未设置状态
项目级版本约束靠 go.mod，不是 gvm 或 g 自动触发
go.mod 文件顶部的 go 1.22 行仅用于校验，不控制环境切换。它会在不匹配时明确报错：
立即学习“go语言免费学习笔记（深入）”；
go: go.mod requires Go >= 1.22 but current version is 1.21.6
此时必须手动用 g install 1.22.3 && g use 1.22.3 切换后再执行构建。这个机制只拒绝非法构建，不干预你的 shell 环境。
长期维护项目建议用 asdf
如果你同时管理 Node、Rust、Python 等多语言环境，asdf 是目前最活跃、插件完善、Shell 集成稳定的通用方案：
- 启用 Go 插件：
asdf plugin add golang https://github.com/kennyp/asdf-golang.git - 安装版本：
asdf install golang 1.21.6 - 设为项目级默认（写入
.tool-versions）：asdf local golang 1.21.6 - 它会自动隔离
GOROOT、管理PATH，每个版本独立安装，互不污染
真正容易被忽略的是：所有工具都依赖干净的 GOROOT 隔离 —— 一旦你手动在 /usr/local/go 下软链多个版本，或让 brew 和 g 共存于同一路径，后续问题几乎必然发生。
