Go fsnotify 怎样给新建子目录补充监听

如果只对根目录调用一次 watcher.Add，程序通常能收到根目录下文件的变化，却收不到新建子目录内部文件的后续事件。原因是 fsnotify 不提供自动递归监听：已有子目录要在启动时逐个添加，新建子目录则要从父目录的 Create 事件中识别出来，再补一次 Add。

官方地址：https://github.com/fsnotify/fsnotify

先确认“子目录没有事件”是正常边界

这个现象很容易被误判成监听器失效。fsnotify 的目录监听只覆盖该目录下的直接成员，不会自动把所有后代目录纳入 watch 集合。因此，根目录、已有子目录和运行中创建的新子目录，其实是三组不同的监听对象。

排查时先看一件事：代码是否只执行了 watcher.Add(root)。如果是，父目录本身的 Create 事件仍可能出现，但它只告诉你“有一个新路径出现了”，不会替你监听这个路径内部后续的文件变化。下面的结构图把这几个职责拆开，便于定位遗漏点。

启动时先把已有目录加入监听集合

新目录监听只能解决运行期间的变化，不能替代启动时的初始化。程序启动后先遍历根目录，把当前存在的目录全部加入；遇到权限错误时保留路径和原始错误，由调用方决定是否跳过或退出。

func addExistingDirs(watcher *fsnotify.Watcher, root string) error {
    return filepath.WalkDir(root, func(path string, entry fs.DirEntry, walkErr error) error {
        if walkErr != nil {
            // 保留具体路径，便于定位权限或目录消失问题。
            return fmt.Errorf("遍历 %q: %w", path, walkErr)
        }
        if !entry.IsDir() {
            // 只给目录建立 watch，文件由目录事件统一过滤。
            return nil
        }
        if err := watcher.Add(path); err != nil {
            // Add 失败属于启动阶段错误，不要伪装成普通文件事件。
            return fmt.Errorf("监听目录 %q: %w", path, err)
        }
        return nil
    })
}

监听目录而不是逐个监听文件，能覆盖目录中后来创建的文件，也能避免编辑器用临时文件替换原文件时丢失单文件 watch。Add 对同一路径重复调用通常是幂等的，但仍应让自己的目录发现逻辑保持清晰，避免无休止地重复尝试。

收到 Create 后判断目录，再补一次 Add

核心动作是处理父目录发出的 Create。事件名称是新路径，不能只根据字符串后缀猜它是不是目录；使用 os.Stat 读取当前文件系统状态更稳妥。目录确认后立即调用 Add，它下面后来出现的文件才会进入事件流。

func watchTree(ctx context.Context, root string) error {
    watcher, err := fsnotify.NewWatcher()
    if err != nil {
        // 创建失败发生在监听循环之前，直接交给上层处理。
        return fmt.Errorf("创建 watcher: %w", err)
    }
    defer func() {
        // 统一释放底层资源，避免重试时遗留旧 watcher。
        _ = watcher.Close()
    }()

    if err := addExistingDirs(watcher, root); err != nil {
        return err
    }

    for {
        select {
        case event, ok := 

这里没有把 Create 当作“目录一定已经准备完毕”。在并发写入场景中，目录可能刚创建就被删除，Stat 失败是合理的竞态；记录这次失败即可，是否重新扫描由业务可靠性要求决定。若新目录本身还包含更早创建的下级目录，可以在确认它是目录后再次调用一个受控的目录遍历函数，而不是只添加这一层。

删除、重命名和高频事件要单独处理

补充监听后，仍要留意三个边界。第一，目录被删除或重命名后，相关 watch 可能被底层自动移除，业务如果要求继续跟踪，需要重新扫描并恢复目录集合。第二，Write 不等于文件已经写完，一次保存动作可能带来多次事件，必要时在业务层做短暂去重或延迟读取。第三，Errors 不能只打印一行就当作无事发生，队列溢出或底层资源异常时，应触发告警、重新扫描或明确降级。

常见问题

只监听根目录，能看到新建子目录吗？

通常能看到根目录上的 Create，但不会自动监听新目录的内部变化。必须根据事件路径再次调用 Add。

新目录里原本就有更深的目录怎么办？

确认新目录后，对它执行一次受控的 WalkDir，为已经存在的下级目录补齐 watch；同时继续处理后续的 Create 事件。

可以只监听新目录，不初始化已有目录吗？

不建议。这样会错过程序启动前已经存在的子目录，正确做法是“启动遍历 + 运行期间 Create 补充”两部分一起保留。