viper.watchconfig()仅触发回调，不自动重载配置；必须在回调中依次调用readinconfig()、unmarshal()并原子替换结构体指针，否则viper.get()和cfg结构体始终返回旧值。
viper.WatchConfig() 为什么改了配置文件却没生效
它只监听变更并调你的回调函数，不读文件、不解析、不更新任何变量——viper.Get() 和你声明的 cfg 结构体都还是旧值。常见现象是日志打印“配置已更新”，但 viper.GetInt("port") 返回的仍是启动时的端口。
- 回调第一行必须是
if err := viper.ReadInConfig(); err != nil { return }，否则viper内部缓存仍是旧内容 - 紧接着必须
if err := viper.Unmarshal(&newCfg); err != nil { return }，viper.Unmarshal()才把新解析结果写进 Go 结构体；漏掉这步，cfg.Port永远卡在初始化那一刻 -
viper.SetConfigType("yaml")必须在viper.ReadInConfig()之前调用，否则类型不匹配会静默失败（比如 YAML 文件被当 JSON 解析） - 别在回调里手动赋值字段，如
cfg.Port = viper.GetInt("port")：嵌套结构、mapstructuretag、默认值全部失效
并发读配置时 panic 或读到“半更新”状态
直接写 cfg = newCfg 或逐字段赋值（如 cfg.Port = 8080）是非原子操作。多个 goroutine 同时读时，可能一个读到新 Port、另一个还读着旧 DBURL，尤其结构体含指针或嵌套 map 时极易 panic。
- 推荐用
sync/atomic.Value存结构体指针：var globalConf atomic.Value，初始化时globalConf.Store(&defaultCfg) - 热更新成功后，必须
globalConf.Store(&newCfg)（注意取地址，不是值） - 业务代码统一用
conf := globalConf.Load().(*Config)读取，类型断言不能省，且Load()后建议判空 - 避免用
sync.RWMutex包裹整个配置读写：读多写少场景下，锁竞争比原子操作更重
Docker/K8s 环境下 WatchConfig 静默失效
现象是“改了文件没反应”，控制台无报错，实际是内核 inotify 资源耗尽或权限问题。
- Linux 容器默认
fs.inotify.max_user_watches极低（常为 8192），报错No space left on device不是磁盘满，而是 inotify 句柄用尽 - Docker 启动必须加参数：
--sysctl fs.inotify.max_user_watches=524288，只调高宿主机无效，容器内也要一致 - K8s 中 ConfigMap 挂载后不更新？先检查挂载点权限：
ls -l /etc/config/app.yaml，确保 Go 进程有读权限（某些镜像 umask 导致文件不可读） - 更稳妥做法：启用轮询模式，启动前设环境变量
VIPER_CONFIG_WATCH_POLL=true（v1.12+ 支持）
监听路径不匹配导致事件收不到
编辑器保存常先写临时文件再 rename，触发的是 Create + Remove，不是 Write；只监听目录（如 "./conf"）在 macOS 下可能漏事件，且无法过滤干扰文件。
- 必须对**具体配置文件路径**调用
watcher.Add("./conf/app.yaml")，别只加目录 - 在
viper.OnConfigChange回调里，先检查e.Name == "app.yaml"再处理，过滤掉.swp、.tmp等临时文件 - 监听路径必须和
viper.SetConfigFile()设置的路径严格一致，否则ReadInConfig()读的和监听的不是同一个文件 - Windows 下 VS Code 等编辑器可能锁住文件，
fsnotify收不到WriteEvent，建议同时监听CreateEvent并过滤*~、.swp
db.SetMaxOpenConns()；HTTP Server 的超时参数没法热更，只能 graceful restart。这些细节不处理，光 reload 成功也没用。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
