fsnotify是唯一靠谱的跨平台文件监听方案，因其能稳定避免fd泄漏、事件遗漏和字节解析错误，而手动封装syscall.Inotify易踩坑且无法复用到macOS/Windows。
别用 syscall.Inotify_* 手动封装，直接上 fsnotify —— 它不是“可选”，而是唯一能稳定跨平台、不漏事件、不泄漏 fd 的方案。
为什么 fsnotify 是唯一靠谱选择
Go 标准库压根没提供 inotify 封装，自己调 syscall.InotifyInit、syscall.InotifyAddWatch 看似底层可控，实则踩坑密集：
- 漏调
syscall.Close→ fd 泄露，进程跑几天后报too many open files - 读
unix.InotifyEvent要手动处理字节对齐、部分读、字段偏移 —— 一个字段算错就解析错整个事件 - inotify 本身不支持递归，你得自己
filepath.WalkDir遍历子目录并逐个Add，macOS/Windows 完全没法复用这套逻辑 - 编辑器原子保存（先写
config.yaml.tmp再rename）时，Write事件根本不会落在目标文件上，手动封装几乎必然漏事件
监听前必须检查的三件事
fsnotify.Watcher.Add() 不会帮你创建路径、不自动解析符号链接、也不校验权限 —— 错误常静默返回或 panic，而非明确报错：
- 用
os.Stat(path)确认路径存在且info.IsDir() == true（监听目录时）或!info.IsDir()（监听单文件） - 若路径是符号链接，先
filepath.EvalSymlinks(path)解析真实路径再Add，否则监听的是链接自身，不是目标内容 - 确保进程对目录有
read权限（否则无法获取子项变更），对文件只需read即可监听修改，无需write
递归监听子目录必须手动做
fsnotify 默认只监听传入路径自身的元数据变更（如被 mv 或 chmod），对子目录里的文件修改完全无感 —— 这不是 bug，是设计使然：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 用
filepath.WalkDir(dir, func(path string, d os.DirEntry, err error) error { ... })遍历所有子目录 - 对每个
d.IsDir() && !d.Type().IsSymlink()的路径，调用watcher.Add(path) - 新增子目录时，仅靠收到
fsnotify.Create事件不够 —— 你得在事件回调里主动watcher.Add(新路径)，否则后续改动收不到 - Linux 上注意
/proc/sys/fs/inotify/max_user_watches限制，监听大量子目录时可能报no space left on device，需提前调高该值
事件过滤和原子写入的典型误判
编辑器（VS Code/vim/Sublime）默认启用原子写入：先生成临时文件（.foo.swp、foo~、.tmp），再 rename 替换原文件。这导致：
-
event.Op & fsnotify.Write != 0判断比event.Op == fsnotify.Write更安全，避免漏掉fsnotify.Chmod | fsnotify.Write这类组合事件 - 必须同时响应
fsnotify.Rename和fsnotify.Write，且优先检查Rename：若filepath.Base(event.Name) == "config.yaml"且event.Op&fsnotify.Rename != 0，大概率是编辑器保存完成 - 用
strings.HasSuffix(event.Name, "~")、strings.HasSuffix(event.Name, ".swp")过滤临时文件，但别仅靠后缀 —— 收到事件后立刻os.Stat(event.Name)，确认文件存在且Size() > 0 -
watcher.Events和watcher.Errors是无缓冲 channel，没人读就会阻塞整个 watcher —— 必须启动 goroutine 持续消费，不能只 select 一次就退出
真正麻烦的不是监听本身，而是事件语义的歧义：同一个用户保存动作，在不同编辑器、不同文件系统、不同平台下触发的事件组合完全不同；event.Name 是相对路径，event.Op 是位掩码，临时文件和原子替换的边界模糊——这些细节不抠清楚，监控逻辑十有八九会漏事件或误触发。
