使用fsnotify库可跨平台监听文件系统事件。需通过go get安装，创建Watcher后启动goroutine监听创建、写入、删除、重命名等事件。
在Go语言中实现文件监控，通常用于配置热更新、日志采集或自动化构建等场景。Golang本身标准库不直接提供文件系统事件监听功能，但可通过第三方库高效实现。目前最常用且稳定的方式是使用 fsnotify 库来监听文件或目录的变化。
使用 fsnotify 监听文件变化
fsnotify 是官方推荐的文件系统通知库，支持跨平台（Linux、macOS、Windows），能监听文件的创建、写入、删除、重命名等事件。
安装 fsnotify：go get github.com/fsnotify/fsnotify基本使用示例：
package main
import (
"fmt"
"log"
"github.com/fsnotify/fsnotify"
)
func main() {
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.Printf("事件: %s\n", event)
if event.Op&fsnotify.Write == fsnotify.Write {
fmt.Println("文件被写入:", event.Name)
}
if event.Op&fsnotify.Remove == fsnotify.Remove {
fmt.Println("文件被删除:", event.Name)
}
case err, ok := <-watcher.Errors:
if !ok {
return
}
log.Println("错误:", err)
}
}
}()
// 添加要监听的文件或目录
err = watcher.Add("/path/to/your/file.txt")
if err != nil {
log.Fatal(err)
}
<-done // 阻塞主程序
}
上述代码创建一个监听器，监控指定文件的变更。当文件被写入或删除时，会打印对应信息。
监控目录与递归监听
fsnotify 默认只监听单个路径。若需监听整个目录及其子目录，需手动遍历并添加每个子目录。
立即学习“go语言免费学习笔记（深入）”；
Evez Github Manager
下载
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
import "path/filepath"
func watchDir(watcher *fsnotify.Watcher, dir string) error {
return filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
}
if info.IsDir() {
return watcher.Add(path)
}
return nil
})
}
调用 watchDir(watcher, "/my/project") 即可监听该目录下所有子目录中的文件变动。
常见触发事件与处理建议
fsnotify 支持多种事件类型，合理判断可避免重复触发或遗漏操作。
- Write：文件被写入。注意编辑器保存可能触发多次，建议结合去抖（debounce）机制。
- Create：新文件创建。适用于日志轮转或上传新增文件。
- Remove：文件被删除。需重新添加监听目标时注意路径有效性。
- Rename：文件被重命名。行为类似删除+创建，需特殊处理。
- 对频繁触发的操作增加延迟合并，例如使用定时器防抖。
- 监听目录时，关注 Create 事件以动态加入新文件的监听。
- 捕获 Remove 和 Rename 后及时清理资源，防止崩溃或漏报。
实际应用场景示例：配置热加载
很多服务需要在不重启的情况下更新配置。通过监听 config.yaml 变化，可以实现自动重载。
if event.Op&fsnotify.Write == fsnotify.Write {
fmt.Println("检测到配置变更，正在重载...")
err := reloadConfig()
if err != nil {
log.Printf("重载失败: %v", err)
} else {
log.Println("配置已更新")
}
}
reloadConfig 函数负责重新读取并解析配置文件，更新内存中的设置。
基本上就这些。使用 fsnotify 能快速构建可靠的文件监控逻辑，关键是处理好事件边界和异常情况。
