fsnotify 是 Go 中监控文件变化最常用稳定的方案，底层封装系统事件接口（如 inotify/kqueue），无需轮询；支持监听目录、需手动处理单文件监听与递归、注意事件丢失及跨平台差异。
用 Go 监控文件变化，fsnotify 是最常用、最稳定的方案。它底层封装了操作系统提供的文件系统事件接口（如 Linux 的 inotify、macOS 的 kqueue、Windows 的 ReadDirectoryChangesW），无需轮询，响应快、资源省。
安装与基础用法
先安装官方库：
go get github.com/fsnotify/fsnotify
最简示例：监听单个文件或目录的增删改事件：
立即学习“go语言免费学习笔记（深入）”；
- 创建 watcher 实例，调用
watcher.Add("path")添加监控路径（只支持目录，若要监文件需加其所在目录） - 启动 goroutine 读取
watcher.Events通道，判断event.Op类型（fsnotify.Write、Create、Remove、Rename） - 别忘了监听
watcher.Errors通道处理异常（比如权限不足、路径被删） - 退出前调用
watcher.Close()释放系统资源
监听文件而非目录的技巧
fsnotify 不直接支持监听单个文件，但有实用解法：
- 添加该文件所在目录为监控目标，收到事件后检查
event.Name是否等于目标文件路径（注意路径比对要用filepath.Abs统一格式） - 若需精确到文件内容变更，可结合
event.Op&fsnotify.Write != 0判断写入事件，并在回调中读取文件最新内容或计算 hash 做差异识别 - 避免误触发：部分编辑器（如 vim）会先写临时文件再 rename，此时会收到
Create+Rename两个事件，建议忽略临时名（如*~、.swp）
生产环境注意事项
实际部署时容易踩坑，这几个点要特别注意：
-
递归监听需手动实现：fsnotify 默认不递归，需遍历子目录并逐个
Add；可用filepath.WalkDir配合错误跳过（如权限拒绝） - 事件可能丢失或合并：高频写入时系统可能合并多个事件为一个（如连续两次 save），业务逻辑不要依赖“每次修改必触发一次 Write”
-
跨平台行为差异：Windows 对符号链接支持弱，macOS 可能延迟略高；建议统一用相对路径 +
filepath.Clean处理，避免路径歧义 - 资源泄漏风险：反复 Add 同一路径不报错但会累积监听句柄，务必确保 Add 前先检查是否已监听，或 Close 后重建 watcher
轻量封装建议
为提升复用性，可简单封装一层：
- 定义结构体封装
*fsnotify.Watcher、回调函数、忽略规则（正则或后缀列表） - 提供
WatchFile/WatchDir方法，内部自动处理路径标准化和子目录遍历 - 暴露
Close和Refresh（重新加载监控路径）方法，便于热更新配置 - 日志打点建议记录事件类型、文件名、时间戳，方便排查静默失败
基本上就这些。fsnotify 本身很轻，上手快，关键在理解它的事件模型和系统限制。不需要复杂框架，几行代码就能稳稳跑起来。
