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，而非明确报错：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 用 os.Stat(path) 确认路径存在且 info.IsDir() == true（监听目录时）或 !info.IsDir()（监听单文件）
• 若路径是符号链接，先 filepath.EvalSymlinks(path) 解析真实路径再 Add，否则监听的是链接自身，不是目标内容
• 确保进程对目录有 read 权限（否则无法获取子项变更），对文件只需 read 即可监听修改，无需 write

递归监听子目录必须手动做

fsnotify 默认只监听传入路径自身的元数据变更（如被 mv 或 chmod），对子目录里的文件修改完全无感 —— 这不是 bug，是设计使然：

• 用 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 是位掩码，临时文件和原子替换的边界模糊——这些细节不抠清楚，监控逻辑十有八九会漏事件或误触发。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！