根本原因是监听路径错误且未正确判断事件类型：必须监听父目录而非单个文件，并用e.Op&fsnotify.Rename!=0检测Rename事件，同时需os.Stat验证文件有效性。
fsnotify.Rename 事件为什么收不到
根本原因不是库不支持，而是你监听的路径没对上。编辑器（如 VS Code、vim）保存文件时普遍采用原子写入：先写临时文件（config.yaml~ 或 .config.yaml.swp），再用 rename 系统调用把临时文件重命名为目标名。这个过程会触发两个事件：原文件被 Remove，新文件被 Create；而你期待的“文件被重命名”其实发生在临时文件 → 目标文件这一步——但该事件的 Name 字段是临时文件路径，不是你关心的最终路径。
常见误判：if e.Op == fsnotify.Rename 永远为 false，因为 e.Op 是位掩码，正确写法是 e.Op&fsnotify.Rename != 0。但更关键的是：你得监听父目录，而不是单个文件。
- 监听
"./config.yaml"→ 原 inode 失效后无后续事件 - 监听
"./"→ 收到event.Name == "config.yaml"的Create或Rename事件，才真正可用 - 收到
Rename事件后，务必os.Stat(event.Name)确认文件存在且非零大小，排除.swp类临时文件
如何区分 Rename 和 Create + Remove 组合
Linux 下 mv a b 触发 Rename；但编辑器保存常走 unlink old && rename tmp new，表现为 Remove + Create。你无法仅靠事件类型断定用户意图，得结合上下文判断。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 维护一个最近 2 秒内触发过
Remove的文件名集合（用map[string]time.Time） - 当收到
Create事件且filepath.Base(e.Name)在该集合中，大概率是原子替换 - 对
Rename事件，检查e.Name是否为你关心的文件名（如"config.yaml"），同时忽略e.OldName—— 它在某些编辑器下为空或不可靠 - macOS 上
Rename可能被合并为Chmod，此时只能 fallback 到os.Stat对比ModTime()和Size()
watcher.Add 后没收到 Rename 事件的排查点
不是代码写错了，而是环境或路径细节卡住了。重点查这三处：
-
watcher.Add()传入的必须是**已存在的目录路径**，比如"./conf"；若路径不存在，Add返回 error 但常被忽略，导致静默失败 - 符号链接默认不跟随：如果
./conf是软链，watcher.Add("./conf")只监听链接文件自身（元数据变化），不是目标目录。需先filepath.EvalSymlinks("./conf")解析真实路径再Add - 容器内 NFS 挂载点不透传 inotify 事件，
watcher不报错但永远无事件。验证方式：ls /dev/inotify，缺失则需启动容器时加--device=/dev/inotify
重复 Rename 事件和漏事件怎么防
同一文件连续重命名（如 git checkout 切分支）可能触发多次 Rename；而通道缓冲不足或未及时读取会导致事件丢失——这不是 bug，是 fsnotify 的设计约束。
- 通道缓冲至少设为
make(chan fsnotify.Event, 100)，小于 50 极易丢事件 - 必须用独立 goroutine 消费
watcher.Events，不能阻塞在主流程里；否则缓冲区满后 fsnotify 内部直接丢弃新事件 - 对相同
event.Name的Rename事件，加 100ms 去重窗口：记录上一次处理时间，间隔太短就跳过 - 关闭 watcher 前，先停掉消费 goroutine，再调
watcher.Close()，最后非阻塞读一次Events和Errors避免 panic
vim 正在后台生成 .foo.un~。 
