Go语言使用fsnotify实现文件变动实时监测

夏知夏

发布时间：2026-10-16 | 6人浏览过

原创

在Go语言开发中，利用 fsnotify 库可以高效地监听文件系统变化。本文将解析核心类型并展示如何通过 NewWatcher 和 Add 函数配合 Channel 机制，实时监控文件或目录的增删改操作。

fsnotify 核心概念与安装

fsnotify 是 Go 语言的跨平台文件系统通知库，提供简单的接口来观察本地文件系统的更改。在使用前，需通过以下命令获取依赖：

$ go get github.com/fsnotify/fsnotify

关键类型结构

理解以下三个核心组件是实现文件监听的基础：

Event 结构体

表示单个文件系统通知，包含路径和操作类型：

type Event struct {
    Name string   // 文件或目录的相对路径
    Op      Op      // 触发通知的文件操作
}
func (e Event) String() string // 返回如 "file: REMOVE|WRITE" 的字符串描述

Op 枚举类型

定义了一系列可触发的文件通用操作：

type Op uint32
const (
    Create Op = 1 << iota // 创建新文件或目录
    Write                 // 写入内容
    Remove                // 删除文件
    Rename                // 重命名
    Chmod                 // 修改权限或属性
)

Watcher 结构体及工厂函数

Watcher 是核心控制器，内部包含用于接收事件的 Events 通道和记录错误的 Errors 通道：

NewWatcher(): 调用底层操作系统 API 创建 Watcher 对象。
Add(name string): 非递归地开始监测指定文件或目录的变化。
Remove(name string): 停止对指定目标的监测。
Close(): 关闭所有监测并关闭事件通道。

完整代码实现与操作顺序

下面是一个完整的示例，展示了如何启动后台协程来持续接收文件变动事件。

初始化 Watcher 并设置延迟关闭：确保程序结束时能清理资源。
启动监控协程：通过 Select 语句同时监听 watcher.Events 和 watcher.Errors。
添加监测目标：调用 watcher.Add("./") 将当前工作目录加入监听列表。
阻塞等待：主 goroutine 保持运行直到收到完成信号。

import (
    "log"
    "github.com/fsnotify/fsnotify"
)

func main() {
    watcher, err := fsnotify.NewWatcher()
    if err != nil {
        log.Fatal("new watcher failed: ", err)
    }
    defer watcher.Close()
    
    done := make(chan bool)
    go func() {
        defer close(done)
        for {
            select {
            case event, ok := <-watcher.Events:
                if !ok {
                    return
                }
                log.Printf("%s %s\n", event.Name, event.Op)
            case err, ok := <-watcher.Errors:
                if !ok {
                    return
                }
                log.Println("error: ", err)
            }
        }
    }()

    err = watcher.Add("./")
    if err != nil {
        log.Fatal("add failed:", err)
    }
    <-done
}