Go环境配置需先设GOROOT、GOPATH、GOPROXY三要素；框架配置非自动生效，Viper需手动调AutomaticEnv()且ReadInConfig()在前，GoFrame依赖GF_ENV或gf.env文件触发config-{env}.toml浅层覆盖，go-zero的-f参数最高优先级并禁用其他配置源。
Go 环境本身不带“框架配置”——所谓“框架配置”，本质是项目级配置管理策略的选择与落地，不是装完 Go 就能自动生效的东西。
Go 安装后必须配的三件事：GOROOT、GOPATH、GOPROXY
很多问题其实卡在环境变量没配对，而不是框架不会用。
-
GOROOT是 Go 安装路径（如C:\Go或/usr/local/go），go env -w GOROOT=...通常不用手动设——.msi或.pkg安装器已写死；但如果你解压.zip或.tar.gz，就必须显式设置 -
GOPATH在 Go 1.16+ 已非必需，但仍有工具（如旧版gopls或某些 CI 脚本）依赖它；建议设为$HOME/go（mac/Linux）或%USERPROFILE%\go（Windows），并把$GOPATH/bin加进PATH -
GOPROXY必须配，否则go mod download会超时失败；推荐命令：go env -w GOPROXY=https://goproxy.cn,direct；验证用go env GOPROXY
配完务必重启终端——CMD/PowerShell/Terminal 不关，go env 看到的还是旧值。
框架配置 ≠ 框架安装：Viper、GoFrame、go-zero 的加载逻辑完全不同
你写 viper.SetConfigFile("config.yaml")，和你设 GF_ENV=prod，和你跑 go run main.go -f etc/app.prod.yaml，三者互不兼容，不能混用。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- Viper 默认不读环境变量，要手动调
viper.AutomaticEnv()才能用os.Getenv覆盖；且viper.ReadInConfig()只加载一个文件，不自动 fallback 到config.dev.yaml - GoFrame 不看
APP_ENV，只认GF_ENV或根目录gf.env文件；config-prod.toml不会自动加载，必须显式声明环境才能触发浅层覆盖 - go-zero 的
-f参数是硬开关：一旦指定，所有环境变量、GO_ENV、默认文件名规则全部失效；想用环境变量驱动，就得去掉-f，靠命名约定（如app.yaml+GO_ENV=prod→ 自动加载app.prod.yaml）
配置结构体字段名大小写、YAML 缩进、连字符全是坑
IOC-golang、Viper、甚至原生 yaml.Unmarshal 都对格式敏感，报错常不提示具体哪行出错。
- YAML 中
timeout: 5s对应 Go 字段必须是Timeout time.Duration，不能是timeout string；Viper 支持类型转换，但 IOC-golang 的config.ConfigString只存原始字符串 - YAML 缩进必须全用空格，混用 Tab 会导致解析失败，
viper.ReadInConfig()返回nil但实际没加载任何内容 - 字段含连字符（如
retry-count）时，Viper 可识别，但结构体 tag 写json:"retry-count"没问题，而mapstructure:"retry-count"可能失效；统一用下划线更稳
真正容易被忽略的点是：配置加载时机。所有框架都要求在 main() 开头就完成初始化，且必须检查 err——比如 viper.ReadInConfig() 失败不 panic，后续 viper.GetString("db.host") 就返回空字符串，服务启动成功却连不上数据库。
