Golang如何监控文件变化使用fsnotify库实现实时监听方案-Golang-PHP中文网

Golang如何监控文件变化使用fsnotify库实现实时监听方案

P粉602998670

发布： 2025-07-02 12:26:02

原创

308人浏览过

使用 fsnotify 监控文件变化的核心方法是创建 watcher 实例并监听事件。首先安装库：go get github.com/fsnotify/fsnotify；然后导入包并创建监听器 watcher, _ := fsnotify.newwatcher()；启动 goroutine 处理事件和错误；通过 watcher.add() 添加监听路径；主协程阻塞等待事件触发。支持的事件包括 create、write、remove、rename 和 chmod。要监听整个目录及其子目录，需用 filepath.walk 遍历并逐个添加子目录。注意点包括处理重复事件、权限问题、跨平台差异及性能限制。

Golang如何监控文件变化使用fsnotify库实现实时监听方案

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
    })
}

登录后复制

这样就能实现递归监听。但要注意的是，大量文件夹可能导致资源占用上升。