使用 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 做文件监控不复杂，但也有一些细节容易忽略，比如递归监听、事件去重、错误处理等。只要把这些点考虑进去，就可以稳定地实现一个实时监听方案了。
