Viper动态加载config-{env}.yaml需显式设置文件名、类型、路径及环境变量映射，否则易导致配置污染、解析失败或环境错乱。
用 Viper 动态加载 config-{env}.yaml 是当前最可控、最易测试的做法，硬编码文件名或多次 ReadInConfig 会导致配置污染和环境错乱。
为什么 viper.ReadInConfig() 找不到 config-dev.yaml
常见错误是没设对文件名或类型。viper 不会自动根据 ENV=dev 去猜文件名，必须手动拼接；也不靠扩展名推断格式，不显式调用 viper.SetConfigType("yaml") 就会报 Unsupported Config Type ""。
- 确保先调
viper.SetConfigName("config-" + os.Getenv("ENV"))，不是"config-dev"硬编码 - 必须在
viper.ReadInConfig()前调viper.SetConfigType("yaml") -
viper.AddConfigPath("./configs")路径要真实存在且可读，别漏掉末尾斜杠或写成"configs/"导致路径拼接异常 - 检查文件权限：Docker 或 Kubernetes 中挂载的 ConfigMap 默认只读，
os.Stat能过但viper.ReadInConfig()可能静默失败
如何让 server.port 正确映射到 SERVER_PORT 环境变量
viper.AutomaticEnv() 默认只做全字符串匹配，不会把点号转下划线。不处理这层，viper.GetString("server.port") 就永远拿不到 SERVER_PORT 的值。
- 尽早调
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) - 设前缀避免冲突：
viper.SetEnvPrefix("app")，这样app.server.port对应APP_SERVER_PORT - 不要依赖
os.Getenv("SERVER_PORT")手动取值——绕过了 viper 的优先级链（flag > env > file > default） - 若需特殊映射（比如
PGHOST→db.host），用viper.BindEnv("db.host", "PGHOST")显式绑定
嵌套结构体 unmarshal 总是空？检查 yaml tag 是否严格匹配
viper 不会自动转换字段命名风格，也不从 YAML key 推导 struct 字段名。它只认 yaml:"xxx" tag，且大小写敏感。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 配置文件写
redis: { host: "127.0.0.1" }，结构体就得是Host string `yaml:"host"` - 嵌套层级每层都要加 tag：
type Config struct { Redis RedisConfig `yaml:"redis"` }+type RedisConfig struct { Host string `yaml:"host"` } - 别混用
mapstructure和yamltag——viper 默认用mapstructure，但设了viper.SetConfigType("yaml")后，必须用yamltag 才生效 - 调试时可用
viper.AllKeys()打印所有已加载 key，确认结构是否被正确解析
生产环境禁用 WatchConfig，基础配置用 MergeConfigFile 显式合并
viper.WatchConfig() 在生产环境热重载有风险：fsnotify 可能丢失事件、并发 reload 导致结构体部分更新、或触发未隔离的业务逻辑 panic。
- 生产启动时只调一次
viper.ReadInConfig()，不启用WatchConfig() - 共用字段（如服务名、端口）拆到
config-base.yaml，用viper.MergeConfigFile("./configs/config-base.yaml")显式合并 - 顺序很重要：base 必须在 env-specific 文件之前 merge，否则会被覆盖
- 敏感字段（如
db.password）YAML 里留空或删掉，只从环境变量读，杜绝提交密钥到 Git
最容易被忽略的是：viper 的配置合并行为是隐式的，ReadInConfig() 多调一次就 merge 一次，没有“覆盖”语义；而 AutomaticEnv() 不处理点号这件事，90% 的人第一次都会踩坑。别信“应该能自动识别”，每个环节都得显式控制。
