viper 配置失效的根源在于加载顺序、优先级和初始化遗漏：必须调 automaticenv() 并设环境键替换器，环境变量不回填已加载值；按需分步加载通用与环境配置文件；结构体绑定需 mapstructure tag；热更新需手动重绑定且加锁保护。
viper 是 Go 生态中事实标准的配置管理库，但它不是“开箱即用就不出错”的工具——配置加载失败、环境变量不生效、热更新卡住、结构体绑定为空，这些都不是 bug，而是没踩对加载顺序、没理清优先级或漏了关键初始化步骤。
为什么 viper.GetString("db.host") 总是空？
这不是 viper 不工作，而是你没告诉它“去哪找环境变量”或“怎么映射键名”。常见现象：本地 .env 里写了 DB_HOST=localhost，但 viper.GetString("db.host") 返回空字符串。
- 必须调用
viper.AutomaticEnv()，否则环境变量完全不参与配置解析 - 默认不支持点号（
.）转下划线（_），需手动加替换器：viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) -
viper.SetEnvPrefix("APP")后，APP_DB_HOST才会映射到db.host；如果只设了前缀却没调AutomaticEnv()，照样无效 - 环境变量只影响后续的
Get*调用，不会回填已从文件加载的值；若文件里已有db.host，它仍优先于环境变量——除非你没调ReadInConfig()或调得太晚
如何正确加载 config.dev.yaml 和 config.prod.yaml？
Viper 默认不识别环境后缀，所谓“自动按 ENV 加载”是假象，得自己控制路径和合并逻辑。
- 先调
viper.SetConfigName("config")+viper.AddConfigPath("./configs")+viper.ReadInConfig()加通用配置 - 再读环境专属文件：
env := os.Getenv("ENV")，若非空，则viper.SetConfigName("config." + env)，再调viper.MergeInConfig()（不是ReadInConfig()） - 不要多次
AddConfigPath同一目录再反复ReadInConfig()，Viper 会按添加路径的逆序扫描，容易误覆盖 - 调试时用
viper.AllSettings()打印最终键值，确认db.host到底来自哪个来源
结构体绑定后字段还是零值？
直接 viper.GetXXX() 容易漏判类型或返回空，但用 Unmarshal 也不保险——tag 写错、嵌套结构没声明、默认值没设，都会导致字段为零值且无报错。
- 结构体字段必须带
mapstructure:"key_name"tag，json:"key_name"不起作用 - 嵌套结构要显式声明，比如
Database DatabaseConfig `mapstructure:"database"`，不能只写DatabaseConfig - 避免用指针字段（如
*string）判断是否设置，改用非空默认值 + 显式校验：if cfg.DB.URL == "" { return errors.New("db.url is required") } -
viper.SetDefault("server.port", 8080)要在ReadInConfig()前调用，否则无效
WatchConfig 热更新为什么没触发回调？
viper.WatchConfig() 只监听文件变更，但不自动重绑定结构体，也不保证线程安全——它只是个信号发射器。
- 必须配合
viper.OnConfigChange(func(e fsnotify.Event) {})手动注册回调 - 回调里要重新调
viper.Unmarshal(&cfg)，否则结构体还是旧值 - 如果配置被多 goroutine 并发读写，得用
sync.RWMutex包裹全局配置变量，读用RLock，写用Lock - 文件被编辑器保存时可能先清空再写入（如 vim），造成短暂解析失败；建议在回调里加重试或忽略临时错误
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
