gvm已归档不建议新环境使用；当前最稳妥方案是用g或asdf管理go版本，因gvm自2017年停更，存在tls连接失败、path注入失效及goroot冲突等问题。
用 gvm 管理 Go 多版本，别碰 $GOROOT 手动改
直接修改 $GOROOT 和 $PATH 是最易翻车的方式：不同终端会话状态不一致、CI 脚本失效、同事搭环境全靠口口相传。gvm 把每个 Go 版本装在 ~/.gvm/gos/ 下，切换时只改当前 shell 的 $GOROOT 和 $PATH，干净隔离。
安装后务必检查 shell 初始化是否生效：
- 执行
source ~/.gvm/scripts/gvm（或重启终端） - 运行
gvm version确认有输出 - 若提示
command not found: gvm，说明~/.gvm/scripts没进$PATH，需在~/.zshrc或~/.bashrc末尾加：source ~/.gvm/scripts/gvmexport PATH="$HOME/.gvm/bin:$PATH"
安装常见失败原因：
- 缺编译工具：Linux 装
build-essential，macOS 装 Xcode Command Line Tools - 下载被墙：设代理
export GVM_GOBIN_URL=https://golang.google.cn/dl/ - 误用
sudo gvm install：gvm 默认用户级安装，root 权限会破坏权限结构
按项目绑定 Go 版本，不是全局切
执行 gvm use go1.21.6 --default 是坑——它让整个终端会话锁定该版本，一旦同时开两个项目（一个要 go1.20，一个要 go1.22），立马冲突。正确做法是进项目根目录后运行：
-
gvm use go1.21.6（生成.gvmrc文件） - 文件内容为
export GVM_GO_VERSION="go1.21.6" - 确保 shell 已启用 cd hook（gvm 安装时默认配置好）
验证是否生效：
-
go version输出必须匹配预期 -
echo $GOROOT应指向~/.gvm/gos/go1.21.6 - 注意：如果
go.mod里声明了go 1.22，而你硬切到go1.21.6，go build会直接报错go: cannot use go 1.21.6 with go 1.22 module—— 这是 Go 编译器强制校验，不是 gvm 的问题
配置多环境别混用 viper 和 .env 文件
viper 在纯 Go 项目里常因两件事翻车：一是默认开启 etcd/consul 监听，没配就静默失败；二是 viper.AutomaticEnv() 和 viper.SetEnvPrefix("APP") 一起用，环境变量名会变成 APP_DB_HOST 而不是 DB_HOST，导致读不到。
更轻量靠谱的做法是用 caarlos0/env 库 + 结构体 tag：
- 字段必须导出（首字母大写）
- 加
env:"DB_HOST" default:"localhost"或required:"true"（敏感字段禁用default） - 启动时调
env.Parse(&cfg)，自动处理空值 fallback、类型转换、必填校验 - 测试时可传
map[string]string注入环境，不用改系统变量
加载 .env 类文件时注意：
-
godotenv.Load(".env.test")不覆盖已有变量，要用godotenv.Overload() - 开发阶段推荐先
Load(".env.local")（本地覆盖），再Load(".env")（基础） - CI/CD 中禁止加载任何
.env*文件，强制走真实环境变量注入
Go Modules 是跨项目协作的底线要求
还在把项目塞进 $GOPATH/src？那是 Go 1.10 时代的遗留问题。所有新项目必须用 Go Modules，否则无法保证依赖一致性，也无法和现代 IDE、CI 工具协同。
初始化只需两步：
-
go mod init github.com/your-org/your-project（模块路径建议用完整导入路径） - 确认
GO111MODULE=on：go env GO111MODULE输出应为on；若不是，执行go env -w GO111MODULE=on
关键点：
- 项目可放在任意路径，比如
~/projects/my-go-app/，无需src/子目录 -
go run main.go和go build都能直接在根目录执行 - 多个 Go 项目并存时，各自
go.mod独立锁定依赖，互不干扰
真正容易被忽略的是：Go Modules 不解决 Go 版本管理问题——它只管依赖，不管 go 命令本身是哪个版本。gvm 管 Go 编译器，Modules 管第三方包，两者职责分明，不能互相替代。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
