goenv 和 viper 是解决 Golang 环境冲突最轻量、最正交的组合：前者管理 Go 版本隔离，后者管理运行时配置；goenv 通过 shim 机制避免 GOROOT 和 PATH 冲突，viper 通过环境变量绑定与多文件合并实现安全、可控的配置加载。
goenv 和 viper 是解决 Golang 环境冲突最轻量、最正交的组合：前者管「Go 语言版本」，后者管「应用运行时配置」，两者不重叠、不耦合，各自隔离得干净。
用 goenv 隔离不同 Go 版本，避免 GOROOT 和 PATH 冲突
多个项目依赖不同 Go 版本（比如一个老项目卡在 1.16，新项目要用 1.22），手动改 GOROOT 或反复替换 /usr/local/go 极易出错——goenv 用 shim 机制彻底绕过这个问题。
- 安装后所有版本都装在
~/.goenv/versions/下，互不干扰 -
goenv local 1.19.13会在当前目录生成.go-version，进目录自动切换，which go指向~/.goenv/shims/go，不是真实二进制 - 切完必须验证：
go version和goenv which go要一致；如果报command not found: go，大概率是~/.goenv/shims没加到PATH最前面 - 卸载旧版本别手删目录，用
goenv uninstall 1.18.10，它会同步清理 shim 脚本，避免残留导致命令错乱
用 viper 实现配置多环境加载，避免硬编码和文件混用
同一个代码库部署到 dev、staging、prod，数据库地址、日志级别、密钥等全靠环境区分——但直接写 config.prod.yaml 并提交到 Git，容易误提敏感信息或漏切环境。
- 推荐结构：
config.yaml（通用字段）+config.dev.yaml（覆盖字段），用viper.MergeConfigMap()合并，比单纯ReadInConfig()更可控 - 加载顺序必须明确：
viper.AutomaticEnv()开启后，环境变量优先级高于文件，所以APP_ENV=prod go run main.go可覆盖配置文件中的env字段 - 敏感字段（如
database.password）绝不写进 YAML，留空或设为""，启动时用viper.BindEnv("database.password", "DB_PASSWORD")绑定环境变量 - 忘记调
viper.SetConfigType("yaml")会导致ReadInConfig()静默失败，建议加if err := viper.ReadInConfig(); err != nil { log.Fatal(err) }强制报错
避免用构建标签（build tags）做配置分流，那是编译期陷阱
有人想用 //go:build prod 控制是否加载监控 client，看似干净，实则埋雷：一旦 go build -tags=prod 打包，所有 dev 相关逻辑（包括调试工具、mock 实现）就彻底消失，本地根本没法测。
- 构建标签适合控制「是否编译某段代码」，比如
dlv调试器只在dev编译，但它不该决定「连接哪个数据库」 - 真正该由环境决定的行为（如是否上报 metrics、是否启用 pprof），应通过配置驱动，而不是编译开关
- 同一包下多个文件满足相同 build tag 会触发
duplicate definition错误，排查成本远高于统一用viper.GetBool("metrics.enabled")
CI/CD 中环境切换要显式、可审计，拒绝隐式继承
GitHub Actions 或 GitLab CI 里常见错误：用 export GOENV_VERSION=1.22 但没调 goenv use，导致实际跑在系统默认 Go 上；或者靠 cp config.prod.yaml config.yaml 覆盖，却忘了清理临时文件。
立即学习“go语言免费学习笔记（深入）”；
- CI 脚本中必须显式执行
goenv use 1.22.3，并紧跟go version校验输出 - 配置加载不要依赖工作目录，用绝对路径：
viper.AddConfigPath("${{ github.workspace }}/configs") - 生产部署前加一道校验：启动时用
viper.Unmarshal(&cfg)解析到结构体，再检查cfg.Database.Host != ""等关键字段，不合法直接os.Exit(1) - 别把环境变量写死在 CI 配置里，用 Secret 注入，且命名带环境前缀，如
PROD_DB_PASSWORD，避免DB_PASSWORD在多个 job 间串扰
goenv 的 shim 和 viper 的 BindEnv 都是隐形开关，一旦配置顺序或路径写错，问题往往延迟到运行时才暴露——所以每次切换后，务必用最小闭环验证：进目录 → go version → go run main.go → 查日志确认加载的是预期配置。 
