直接监听单个文件无效，因编辑器原子写入会销毁原inode；必须监听父目录，用filepath.Base()过滤事件，并同时处理Write和Rename事件，且需检查文件存在性及临时后缀。
直接监听单个配置文件（如 watcher.Add("config.yaml")）基本无效——编辑器保存时用的是原子写入，旧文件 inode 被销毁，新文件是“新建”的，fsnotify.Write 根本不会触发。
为什么 fsnotify.Add("config.yaml") 总不生效
VS Code、vim、Sublime 等编辑器默认启用原子写：先写临时文件（如 config.yaml~、.config.yaml.swp 或 config.yaml12345），再 rename 覆盖原路径。此时你监听的文件描述符已失效，系统不会发 Write 事件，只可能收到 Remove + Create 或 Rename。
- 监听单个文件时，
Rename事件无法被当前句柄捕获，必须监听父目录 -
os.Stat("config.yaml")在事件回调里返回 “no such file” 是正常现象，说明编辑器正处于删旧写新中间态 - macOS 下监听单个文件还容易因 kqueue 机制漏事件；Linux 容器中挂载宿主机配置文件（
-v ./config.yaml:/app/config.yaml）时，overlayfs 不支持 inotify 穿透，监听必然静默失败
正确监听方式：必须监听目录 + 过滤文件名
监听配置所在目录（如 "./conf"），在事件中用 filepath.Base(event.Name) 判断是否为目标文件，并主动过滤临时后缀。
- 调用
watcher.Add("./conf")，不是watcher.Add("./conf/config.yaml") - 只响应
e.Op&fsnotify.Write != 0或e.Op&fsnotify.Rename != 0——别用==直接比较，e.Op是位掩码 - 收到事件后立刻
os.Stat(event.Name)，确认文件存在、长度 > 0、且后缀不在[]string{".swp", "~", ".tmp", ".yaml12345"}中 - 为防编辑器抖动（如 vim 多次 rename），可加 50–100ms 延迟再读取，或用简单去抖：记录上一次成功 reload 时间，间隔
viper.WatchConfig() 静默失败的常见原因
viper.WatchConfig() 底层也依赖 fsnotify，但封装隐藏了太多细节，出问题时往往没日志、不 panic、也不报错。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 没在
WatchConfig()后阻塞主线程（比如没启 HTTP server，也没select{}），进程启动完就退出，监听器根本没机会工作 -
viper.SetConfigFile("/abs/path/config.yaml")和viper.WatchConfig()必须配对使用；若只调AddConfigPath()+SetConfigName()，viper 默认监听工作目录，路径错位导致事件收不到 -
viper.SetConfigType("yaml")必须在ReadInConfig()和WatchConfig()之前调用，否则解析失败会静默跳过 -
OnConfigChange回调里漏掉viper.ReadInConfig()或viper.Unmarshal(&cfg)，等于白监听：缓存 map 和结构体字段都不会更新
reload 后 DB/日志/HTTP 客户端没变？那不是配置没热更，是你没通知它们
配置热加载只是把 YAML 解析成 Go 结构体，它不会自动让下游组件响应变更。所谓“热”，是你要主动把新值喂给真正干活的模块。
-
sql.DB连接池大小变了？必须显式调db.SetMaxOpenConns(cfg.Pool.MaxOpen)和db.SetMaxIdleConns(cfg.Pool.MaxIdle)，这两个方法线程安全 - 日志级别改了？不能只改
cfg.Log.Level，得调logger.Level().SetLevel(zapcore.Level)（zap）或对应 logger 实例的 setter - HTTP Server 的
ReadTimeout、WriteTimeout等字段无法热更，只能 graceful restart —— 这不属于配置热加载范畴 - 自定义开关或限流阈值，别直接暴露结构体字段，封装成带
sync.RWMutex的 getter：func IsFeatureEnabled() bool { mu.RLock(); defer mu.RUnlock(); return cfg.Feature.Enabled }
最常被忽略的一点：热重载不是“监听 → 解析 → 赋值”三步就完事。关键在“谁消费这个配置”，以及“消费方是否真的拿到了新值”。很多人 reload 日志显示成功，但 DB 还连着旧地址，问题一定出在没找到那个 sql.Open() 或 http.NewClient() 的初始化入口点。
