viper 不自动按 env 切换配置文件，需手动设名；嵌套字段须用 mapstructure tag；环境变量需 setenvkeyreplacer 才能映射；结构体字段应设 default 值并校验。
怎么让 viper 自动加载 config.dev.yaml 而不是只认 config.yaml
viper 默认不会根据 ENV 环境变量自动切换文件名，它只按你调用的 viper.SetConfigName() 去找；所谓“多环境支持”其实是靠手动干预实现的。
常见错误现象：设了 ENV=prod，但程序仍加载 config.yaml，config.prod.yaml 完全没被读取。
- 必须在
viper.ReadInConfig()之前，显式调用viper.SetConfigName("config." + env) -
env要从os.Getenv("ENV")或命令行参数获取，不能硬编码在 if 分支里（否则测试易漏） - 要再调一次
viper.AddConfigPath("./configs")（如果路径和初始不同），否则可能报Config File Not Found - 推荐用
viper.MergeInConfig()而非二次ReadInConfig()，避免覆盖已加载的通用配置
viper.GetString("db.host") 返回空字符串，但配置文件明明写了
这不是文件没读到，而是字段映射失败——viper 对嵌套结构体字段默认不识别，必须靠 mapstructure tag 显式声明。
使用场景：YAML 里写的是 database: { host: "127.0.0.1" }，但结构体字段没加 tag，viper.GetString("database.host") 就永远为空。
- 所有嵌套层级的字段都必须加
mapstructuretag，哪怕名字完全一致，例如：Host string `mapstructure:"host"` - 连字符字段（如
max-connections）必须写成`mapstructure:"max-connections"`，不能驼峰 - 顶层字段可省略 tag，但一旦有嵌套（比如
type DB struct { Host string }），内部字段就必须带 - 别依赖
viper.Get("database.host")调试，先用viper.AllKeys()打印实际解析出的 key 列表
环境变量 APP_DB_HOST 为啥没覆盖配置文件里的 db.host
viper 不会自动把 . 转成 _，APP_DB_HOST 默认映射不到 db.host，除非你告诉它怎么转。
性能影响：没配好 key 映射，会导致环境变量完全失效，生产环境密钥传不进去，但程序还不报错。
- 必须调用
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，否则APP_DB_HOST≠db.host -
viper.AutomaticEnv()和viper.SetEnvPrefix("APP")要成对出现，顺序无所谓，但缺一不可 -
BindEnv("db.host", "APP_DB_HOST")是更精确的写法，适合只覆盖个别敏感字段 - 注意：环境变量优先级高于文件，但仅对后续
Get*生效；已通过Unmarshal绑定的结构体不会自动刷新
为什么 Unmarshal 到结构体后某些字段还是零值
因为 viper 默认不处理结构体字段的零值兜底，Port int 在 YAML 里没写就是 0，不是“未设置”，而 0 对端口可能是非法值。
容易踩的坑：直接用 viper.GetInt("server.port") 拿到 0，传给 http.ListenAndServe 导致 panic，但错误堆栈里看不到配置问题。
- 结构体字段初始化时就要设默认值：
Port int `mapstructure:"port" default:"8080"` - 禁用指针字段（如
*int）来判断是否设置——这会让校验逻辑变重且易错 -
viper.Unmarshal(&cfg)后必须做字段级校验，比如if cfg.Server.Port - 生产环境务必禁用
viper.WatchConfig()，热更新可能触发未校验的中间状态
最常被忽略的一点：viper 的 “合并” 是浅层覆盖，config.yaml 里定义了 redis 全部字段，config.prod.yaml 只改了 redis.host，那 redis.port 就会丢失——得靠 MergeInConfig 或统一用结构体 + default tag 来兜底。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
