viper.WatchConfig()没触发回调的根本原因是漏掉三个强制前置动作：未调用viper.ReadInConfig()初始化缓存、未在ReadInConfig前设置viper.SetConfigType("yaml")、未显式注册viper.OnConfigChange()回调；Watch仅发送事件，无回调则事件被丢弃。
viper.WatchConfig() 为什么没触发回调
根本原因不是监听失效，而是你漏掉了三个强制前置动作：没调 viper.ReadInConfig()、没设 viper.SetConfigType("yaml")、没注册 viper.OnConfigChange()。Watch 只发事件，不解析内容；没回调，事件直接丢弃。
-
viper.ReadInConfig()必须成功执行一次，否则后续监听无意义——它初始化内部缓存并确认文件可读 -
viper.SetConfigType("yaml")必须在viper.ReadInConfig()之前调，否则解析失败且静默退出 -
viper.OnConfigChange()必须显式注册，且要放在viper.WatchConfig()之后（顺序不能反） - 监听路径必须是具体文件，比如
viper.SetConfigFile("./config.yaml")，设成目录会收一堆 .swp/.tmp 事件
fsnotify 监听不到文件变更的常见陷阱
编辑器保存配置文件时常用原子写入（先写临时文件再 rename），导致你监听目录却只收到 Rename 或 Create 事件，而非 Write。根本问题在于监听对象和实际被 Viper 加载的文件路径不一致。
- 永远对**具体文件路径**调
watcher.Add("./config.yaml")，别加"./config"目录 - 回调里检查
e.Name == "config.yaml"，过滤掉.yaml.swp、.yaml~等干扰项 - Linux 下注意
/proc/sys/fs/inotify/max_user_watches默认值太小，多服务共用时容易超限，建议设为524288 - 不要依赖
viper.WatchConfig()底层的 fsnotify 实现——它封装了细节但不暴露事件类型，调试时直接用原生fsnotify.Watcher更可控
结构体字段始终不更新？Unmarshal 没重调
Viper 的热加载只刷新它内部的 map[string]interface{} 缓存，不会自动把新值写回你已声明的 Go 结构体变量。你初始化时调了一次 viper.Unmarshal(&cfg)，之后没再调，cfg 就永远停在那一刻。
- 每次
viper.OnConfigChange()触发后，必须显式再执行一遍viper.Unmarshal(&cfg) - 禁止在回调里手动赋值字段（如
cfg.Port = viper.GetInt("port")），嵌套结构、默认值、类型校验全丢失 - 如果结构体含
map、slice或指针字段，确保初始化时已分配内存，否则Unmarshal可能 panic - 解析失败时
&cfg不变，但错误信息像yaml: unmarshal errors:\n line 5: cannot unmarshal !!str `abc` into int必须打日志，不能忽略
并发读写配置导致 panic 或中间态
直接赋值全局变量 cfg = newCfg 是非原子操作：结构体字段多时，某个 goroutine 可能读到部分新、部分旧的值；并发写更会触发 data race。
立即学习“go语言免费学习笔记（深入）”；
- 推荐用
atomic.Value存结构体指针：var globalConf atomic.Value，写入用globalConf.Store(&newCfg)，读取用globalConf.Load().(*Config) - 若需细粒度控制（比如配置变更后主动通知组件），改用
sync.RWMutex包裹整个配置结构体，读用RUnlock()，写用Lock() - 业务代码统一通过
GetConfig() *Config访问，内部做类型断言，不暴露atomic.Value或锁 - 禁止在热加载回调里直接修改全局变量或调用有副作用的函数（如重建 HTTP client），应发 channel 或起 goroutine 异步处理
Unmarshal，且必须用不可变实例 + 原子指针替换，而不是就地更新字段。 
