使用 fsnotify 监控文件系统变化的步骤如下：1. 安装库并导入；2. 创建 watcher 并添加监听路径；3. 遍历目录结构递归监听子目录；4. 在事件循环中判断事件类型并处理；5. 结合防抖等机制优化实际应用逻辑。 fsnotify 基于操作系统底层实现高效监控，支持 create、write、remove、rename、chmod 等事件类型，但需注意编辑器写入方式、权限、跨平台差异及实时处理效率等问题。
在实际开发中，很多场景都需要监控文件系统的变化，比如配置文件自动重载、日志采集、热更新等。Golang 本身没有内置的文件监控机制，但借助社区提供的 fsnotify 库，我们可以很方便地实现这一功能。
安装 fsnotify
首先你需要安装这个库：
go get github.com/fsnotify/fsnotify
导入之后就可以开始使用了。它基于操作系统提供的 inotify（Linux）、kqueue（BSD / macOS）或 ReadDirectoryChangesW（Windows）来监听事件，性能和兼容性都不错。
立即学习“go语言免费学习笔记（深入）”；
基本用法：监听单个文件或目录
要监听一个文件或者目录的变化，可以这样写：
watcher, err := fsnotify.NewWatcher()
if err != nil {
log.Fatal(err)
}
defer watcher.Close()
err = watcher.Add("/path/to/file_or_dir")
if err != nil {
log.Fatal(err)
}
for {
select {
case event, ok := <-watcher.Events:
if !ok {
return
}
log.Println("event:", event)
if event.Op&fsnotify.Write == fsnotify.Write {
log.Println("modified file:", event.Name)
}
case err, ok := <-watcher.Errors:
if !ok {
return
}
log.Println("error:", err)
}
}这段代码创建了一个 watcher，添加了监听路径，并进入循环等待事件。当文件被写入时会打印出信息。
- 支持监听的事件类型包括：Create、Write、Remove、Rename、Chmod。
- 如果你只想关注某些特定操作，可以通过按位与判断。
监听整个目录结构变化的小技巧
默认情况下，fsnotify 只能监听已存在的某个目录下的直接子项变化，不会递归监听子目录。如果你需要监听整个目录树，得自己遍历所有子目录并逐个 add。
一种常见做法是先递归扫描目录，把每个子目录都加入监听列表：
filepath.WalkDir(rootPath, func(path string, d os.DirEntry, err error) error {
if err != nil {
return err
}
if d.IsDir() {
err = watcher.Add(path)
if err != nil {
log.Println("add dir failed:", path)
}
}
return nil
})注意：如果在运行过程中新增了目录，也需要主动调用 watcher.Add() 添加进去。
另外，有些时候你会发现明明改了文件却没收到通知。这种情况可能是因为编辑器采用了“覆盖写入”方式（比如先写临时文件再替换），这时候 Rename 和 Write 都可能出现，需要注意处理逻辑是否覆盖这些情况。
实际应用建议
在实际项目中，我们通常不只是监听到事件就完事了，而是要做一些后续处理，比如重新加载配置、触发任务等。这时候要注意几点：
- 避免重复处理：短时间内可能会连续多次 Write，可以用去重或防抖的方式控制频率。
- 异步处理：不要在事件回调里做耗时操作，否则会影响主监听协程。
- 权限问题：确保程序有权限读取和监听目标路径。
- 跨平台差异：不同系统的实现机制略有差别，测试时最好覆盖多个环境。
例如你可以结合 time 包做一个简单的防抖：
var debounceTimer *time.Timer
// 在事件处理部分
if event.Op&fsnotify.Write == fsnotify.Write {
if debounceTimer != nil {
debounceTimer.Stop()
}
debounceTimer = time.AfterFunc(500*time.Millisecond, func() {
// 执行你的处理逻辑
})
}这样即使短时间内多次修改，也只会执行一次。
基本上就这些。用好 fsnotify 的关键是理解它的事件模型和边界限制，在此基础上做一些封装和优化就能满足大多数需求。
