fsnotify监听单个文件无效，必须监听父目录并按event.Name过滤；需处理编辑器原子写入（Rename事件代表保存完成）；递归监听需手动实现；Events通道必须及时消费以防丢失事件。
直接监听单个文件基本无效，fsnotify 只响应目录层级的系统事件；真正可靠的做法是监听父目录 + 在回调里按 event.Name 过滤目标路径，并处理编辑器原子写入（如 Rename）带来的路径切换。
为什么 watcher.Add("config.yaml") 没反应
因为 fsnotify 底层依赖 inotify/kqueue/ReadDirectoryChangesW，这些机制只支持监听**目录节点**，不接受纯文件路径。调用 watcher.Add("config.yaml") 在 Linux/macOS 下会静默失败（返回 no such file or directory 或更隐蔽的 invalid argument），Windows 甚至可能 panic。
- 必须改用
watcher.Add(filepath.Dir("config.yaml"))，即监听其所在目录 -
event.Name是相对路径（如"config.yaml"），需和目标文件名做字符串或路径比对，推荐用filepath.Base(event.Name) == "config.yaml" - 若路径含软链，先用
filepath.EvalSymlinks()解析真实路径再取Dir，否则监听可能失效
如何正确捕获编辑器保存后的“最终内容”
Vim、VS Code 等默认使用原子写入：先写临时文件（如 .config.yaml654321），再 Rename 覆盖原文件。此时原 inode 被丢弃，仅监听 Write 会读到脏临时文件，或根本收不到事件。
- 必须同时关注
fsnotify.Write和fsnotify.Rename，且优先响应后者——Rename才代表“覆盖完成” - 判断逻辑应为：
if event.Op&fsnotify.Rename != 0 && filepath.Base(event.Name) == "config.yaml" - 某些编辑器（如 macOS 上的 TextEdit）还会夹带
Chmod，别用strings.Contains(event.String(), "RENAME")判断，而要用位运算：event.Op & fsnotify.Rename != 0
递归监听子目录必须手动实现
fsnotify.Watcher 默认不递归，watcher.Add("/a") 只监听 /a 目录本身的元数据变化（如被重命名），对其下 /a/b/ 或 /a/b/c.txt 的改动完全无感。
立即学习“go语言免费学习笔记（深入）”；
- 启动时全量注册：用
filepath.WalkDir(root, ...)遍历所有子目录，对每个d.IsDir()为 true 的路径调watcher.Add(path) - 运行时动态响应：在事件循环中监听
fsnotify.Create，并用event.IsDir()判断是否为新目录，是则立刻watcher.Add(event.Name) - 注意加锁：多个 goroutine 可能并发调
Add，需用sync.Mutex保护 - 避免无限递归：跳过符号链接（
entry.Type() & os.ModeSymlink != 0），否则可能触发权限错误或死循环
Events channel 阻塞会导致事件丢失
watcher.Events 是无缓冲 channel，没人读就会卡住 watcher 内部的系统事件读取 goroutine，后续事件堆积后被内核丢弃（Linux inotify 队列满）、甚至导致整个 watcher 失效。
- 必须在
watcher.Add()前或后立即起 goroutine 消费：go func() { for e := range watcher.Events { /* 处理 */ } }() - 别把
watcher.Close()放在 main 函数末尾就完事——要确保消费 goroutine 已退出，否则Close()会关闭 channel 导致 panic；建议用sync.WaitGroup协作 - 高频率写入（如日志轮转、rsync）下，事件可能合并或丢失，业务层需加防抖：对同一文件路径的
Write/Rename，用time.AfterFunc(100 * time.Millisecond, ...)延迟统一处理
最易被忽略的是资源泄漏：不调 watcher.Close() 不仅泄露 inotify fd（Linux）或 kqueue port（macOS），还会让内部 goroutine 永不退出；而调得太早又会让 channel 关闭后继续读取引发 panic。真正的安全封装，得把 Events 消费、Close、错误恢复全包进一个结构体里控制生命周期。
