viper.WatchConfig()仅触发回调，不自动读取或解析配置；必须在OnConfigChange回调中依次执行ReadInConfig()、Unmarshal()并原子替换配置指针，否则viper.Get()始终返回旧值。
viper.WatchConfig() 不会自动刷新配置值，必须在回调中显式重读文件并重新解析结构体，否则 viper.Get() 仍返回旧值。
为什么改了 config.yaml，viper.GetInt("port") 还是旧的？
根本原因：viper.WatchConfig() 只注册文件监听、触发回调，不执行任何读取或解析动作。它甚至不会碰内存里的缓存。
常见错误现象：
- 回调里只打印日志，没调
viper.ReadInConfig() - 调了
viper.ReadInConfig()，但没检查错误，失败后继续执行Unmarshal - 调了
Unmarshal(&cfg)，但cfg是局部变量，业务代码仍在读全局未更新的副本
正确做法必须包含三步：监听 → 重读 → 重解析 → 原子替换。
立即学习“go语言免费学习笔记（深入）”；
viper.OnConfigChange 回调里必须做什么？
回调不是“通知你改了”，而是“给你一次安全更新的机会”。漏掉任一环节都会导致热更新失效。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
实操要点：
- 第一行必须是
if err := viper.ReadInConfig(); err != nil { log.Printf("reload failed: %v", err); return } - 紧接着调
viper.Unmarshal(&newCfg)，不能依赖viper.Get()实时取值（它读的是旧缓存） - 若用结构体变量存储配置，必须用
sync.RWMutex或sync/atomic.Value保证读写原子性 - 避免在回调里做 HTTP 请求、DB 查询等耗时操作，否则阻塞 fsnotify 事件循环，后续变更被丢弃
YAML 数字字段热加载后变成 float64 怎么办？
这是 Go 标准库 yaml.Unmarshal 的行为，Viper 无法绕过。比如 YAML 写 timeout: 30，解析后是 float64(30)，而结构体字段定义为 int，viper.Unmarshal() 会静默失败（字段保持零值），且不报错。
解决路径：
- 结构体字段统一用
int64或float64，避免类型强制转换 - 用
mapstructure.DecodeHook注册类型转换钩子，把float64 → int显式转 - 更稳妥：在 Unmarshal 后加校验逻辑，对关键字段做类型断言和赋值，例如
if f, ok := v["timeout"].(float64); ok { cfg.Timeout = int(f) }
Docker/K8s 环境下 viper.WatchConfig() 静默失效
现象是“改了文件无反应”，控制台无报错，大概率是 inotify 资源耗尽。
排查与修复：
- 容器内执行
cat /proc/sys/fs/inotify/max_user_watches，若 ≤ 8192 就极可能触发限制 - Docker 启动时必须加
--sysctl fs.inotify.max_user_watches=524288，仅调高宿主机无效 - K8s 中需在
securityContext.sysctls里显式声明，例如- name: fs.inotify.max_user_watches value: "524288" - 软链接（symlink）路径在某些 Linux 发行版下无法触发事件，确保
viper.ConfigFileUsed()返回的是真实文件路径
Windows 下记事本保存会先清空再写入，导致回调触发两次；开发阶段建议用 VS Code 或 vim 保存配置文件。
