使用 fsnotify 监控文件变化的核心方法是创建 watcher 实例并监听事件。首先安装库：go get github.com/fsnotify/fsnotify；然后导入包并创建监听器 watcher, _ := fsnotify.newwatcher()；启动 goroutine 处理事件和错误；通过 watcher.add() 添加监听路径；主协程阻塞等待事件触发。支持的事件包括 create、write、remove、rename 和 chmod。要监听整个目录及其子目录，需用 filepath.walk 遍历并逐个添加子目录。注意点包括处理重复事件、权限问题、跨平台差异及性能限制。
golang 要监控文件变化，最常用的方法就是使用 fsnotify 这个第三方库。它封装了底层的系统调用（比如 inotify on linux、kqueue on BSD/Darwin），使用起来简单又高效。
下面我来分享一下怎么用 fsnotify 来实现实时监听文件或目录的变化。
安装 fsnotify 库
首先，你需要安装这个库：
立即学习“go语言免费学习笔记（深入）”；
go get github.com/fsnotify/fsnotify
然后在代码中导入：
import "github.com/fsnotify/fsnotify"
创建并启动一个文件监听器
使用 fsnotify 的核心是创建一个 Watcher 实例，然后通过它去监听特定路径下的变化。
watcher, err := fsnotify.NewWatcher() if err != nil { log.Fatal(err) } defer watcher.Close() done := make(chan bool) go func() { for { select { case event, ok := <-watcher.Events: if !ok { return } fmt.Println("事件详情：", event) if event.Op&fsnotify.Write == fsnotify.Write { fmt.Println("文件被写入了：", event.Name) } case err, ok := <-watcher.Errors: if !ok { return } fmt.Println("错误信息：", err) } } }() err = watcher.Add("/path/to/watch") if err != nil { log.Fatal(err) } <-done // 阻塞主程序退出
上面这段代码做了几件事：
- 创建了一个监听器；
- 启动一个 goroutine 监听事件和错误；
- 添加了一个要监听的路径；
- 主协程阻塞等待事件触发。
支持监听的事件类型有哪些？
fsnotify 支持几种常见的文件系统操作事件，包括：
- Create：文件或目录被创建；
- Write：文件内容被写入；
- Remove：文件或目录被删除；
- Rename：文件或目录被重命名；
- Chmod：权限变更。
你可以根据具体需求判断事件类型，例如：
if event.Op&fsnotify.Create == fsnotify.Create { fmt.Println("新文件被创建了：", event.Name) }
注意：有些系统对某些事件的支持可能有限，比如 windows 下 Rename 和 delete 有时会混在一起。
如何监听整个目录及其子目录？
默认情况下，Add() 只能监听当前指定目录的一层内容。如果你需要递归监听所有子目录，就得自己遍历添加。
可以这样做：
- 使用 ioutil.ReadDir() 或 os.ReadDir() 遍历目录；
- 对每个子目录都调用 watcher.Add()；
- 如果有新增目录，也要动态添加到监听列表里。
示例思路如下：
func addWatch(watcher *fsnotify.Watcher, path string) { filepath.Walk(path, func(p string, info os.FileInfo, err error) error { if err != nil { return err } if info.IsDir() { watcher.Add(p) } return nil }) }
这样就能实现递归监听。但要注意的是，大量文件夹可能导致资源占用上升。
常见问题和注意事项
- 重复事件：同一个操作可能会触发多个 Write 事件，建议加个去重逻辑或者防抖机制。
- 权限问题：确保运行程序的用户有权访问你要监听的目录。
- 跨平台差异：Linux 下支持比较全面，Macos 和 Windows 上行为略有不同，测试时要注意。
- 性能限制：如果监听成千上万个文件，记得关注内存和 CPU 使用情况。
基本上就这些。用 fsnotify 做文件监控不复杂，但也有一些细节容易忽略，比如递归监听、事件去重、错误处理等。只要把这些点考虑进去，就可以稳定地实现一个实时监听方案了。
