Go语言使用fsnotify监控指定文件的正确用法咨询

原示例代码存在的问题 #

你参考的这段示例写法并不正确，存在几处明显的逻辑缺陷，也不符合最佳实践要求：

• 代码中创建的done通道没有任何写入逻辑，执行到<-done时会永久阻塞，后续的文件读取、watcher关闭逻辑永远不会触发
• 事件处理goroutine是无退出判断的死循环，watcher关闭后会出现通道读写panic
• 你引用的旧版github.com/howeyc/fsnotify仓库已经停止维护，目前社区维护的正式版本API有调整，不建议再使用旧导入路径
• 文件读取逻辑放在了永久阻塞的代码之后，完全不会执行，更无法实现文件变更后自动重读的需求

单文件监控的实现方式 #

如果只需要监控单个指定文件，不需要监控上层目录，直接在调用watcher的添加监控方法时传入目标文件的完整路径即可。
以下是符合你需求的可运行实现：

package main

import (
	"log"
	"os"
	"path/filepath"
	"time"

	"github.com/fsnotify/fsnotify"
)

// 全局存储文件内容，多goroutine读写时建议加读写锁保证并发安全
var fileContent []string

func readFile(path string) ([]string, error) {
	// 替换为实际的文件读取逻辑，示例为按行读取返回字符串切片
	content, err := os.ReadFile(path)
	if err != nil {
		return nil, err
	}
	return splitLines(string(content)), nil
}

func splitLines(s string) []string {
	var lines []string
	start := 0
	for i := 0; i < len(s); i++ {
		if s[i] == '\n' {
			lines = append(lines, s[start:i])
			start = i + 1
		}
	}
	if start < len(s) {
		lines = append(lines, s[start:])
	}
	return lines
}

func main() {
	// 替换为需要监控的目标文件路径
	targetFilePath := "./test.txt"
	absPath, err := filepath.Abs(targetFilePath)
	if err != nil {
		log.Fatal("路径解析失败:", err)
	}

	watcher, err := fsnotify.NewWatcher()
	if err != nil {
		log.Fatal("创建watcher失败:", err)
	}
	defer watcher.Close()

	// 程序启动时先读取一次文件内容
	fileContent, err = readFile(absPath)
	if err != nil {
		log.Fatal("初始读取文件失败:", err)
	}
	log.Println("初始读取文件完成，当前内容行数:", len(fileContent))

	// 直接传入目标文件路径添加监控，无需传入上层目录
	err = watcher.Add(absPath)
	if err != nil {
		log.Fatal("添加文件监控失败:", err)
	}

	// 防抖定时器，避免编辑器保存时触发多次事件导致重复读取
	var debounceTimer *time.Timer
	const debounceDuration = 100 * time.Millisecond

	// 事件处理循环
	for {
		select {
		case event, ok := <-watcher.Events:
			if !ok {
				return
			}
			// 过滤无关事件，只处理写入、重命名、删除类操作
			if event.Op&(fsnotify.Write|fsnotify.Rename|fsnotify.Remove) == 0 {
				continue
			}

			// 防抖逻辑：事件触发后重置定时器，等100ms无新事件再执行读取
			if debounceTimer != nil {
				debounceTimer.Stop()
			}
			debounceTimer = time.AfterFunc(debounceDuration, func() {
				// 原子保存场景（编辑器常用逻辑）会触发重命名/删除事件，需要重新添加监控
				if event.Op&(fsnotify.Rename|fsnotify.Remove) != 0 {
					time.Sleep(50 * time.Millisecond) // 等待新文件写入完成
					if err := watcher.Add(absPath); err != nil {
						log.Println("重新添加监控失败:", err)
						return
					}
				}
				// 读取最新文件内容
				newContent, err := readFile(absPath)
				if err != nil {
					log.Println("读取文件失败:", err)
					return
				}
				fileContent = newContent
				log.Println("检测到文件变更，已重新读取，当前内容行数:", len(fileContent))
			})

		case err, ok := <-watcher.Errors:
			if !ok {
				return
			}
			log.Println("监控错误:", err)
		}
	}
}

关键注意点 #

• 旧版fsnotify调用Watch()方法、新版调用Add()方法时，直接传入目标文件路径即可实现单文件监控，不需要额外监控父目录
• 大部分编辑器保存文件采用原子写逻辑（先写临时文件再替换原文件），会触发Rename/Remove事件，必须重新添加监控，否则后续变更无法捕获
• 必须加防抖逻辑，否则一次保存操作可能触发3-4次事件，导致重复读取文件
• 如果存储文件内容的变量会被多个goroutine读写，需要加读写锁保证并发安全，避免读写冲突

内容的提问来源于stack exchange，提问作者X T