必须用filepath.WalkDir而非filepath.Walk：Go 1.16+唯一推荐的递归遍历方式，返回fs.DirEntry，d.Name()和d.IsDir()零开销，避免隐式os.Lstat性能损耗，且能正确处理权限错误与符号链接。
递归搜索目录必须用 filepath.WalkDir，不是 filepath.Walk
Go 1.16+ 下，filepath.WalkDir 是唯一推荐的递归遍历方式。它返回 fs.DirEntry，调用 d.Name() 和 d.IsDir() 都是零开销，不触发额外 os.Stat；而 filepath.Walk 对每个条目都隐式调用 os.Lstat，在深层嵌套或大量文件时性能差 20%–40%，且遇到 /proc 权限拒绝会直接中断。
常见错误：用 filepath.Walk 扫描时程序突然退出，日志只显示 permission denied——其实是遍历被终止了，不是“跳过”。
- 初始化前先
os.Stat(root)确保根路径存在且为目录，避免后续 panic - 回调中用
errors.Is(err, fs.ErrPermission)判定权限错误，返回filepath.SkipDir继续扫描兄弟路径 - 判断是否为符号链接：用
d.Type() & fs.ModeSymlink != 0，别依赖d.Info()，后者可能触发冗余系统调用甚至返回空名 - 需要完整
os.FileInfo（比如读取修改时间）时，仅对目标文件调用d.Info()，目录项跳过
fsnotify 递归监听要分两步：启动全量注册 + 运行时动态添加
fsnotify.Watcher 本身不支持递归，Add() 只监听显式传入的路径，子目录不会自动加入。指望 watcher.Add("/a/b") 就能收到 /a/b/c/file.txt 的事件，结果只会静默漏掉。
典型现象：新增子目录后，里面改文件完全没事件；或者启动后创建的嵌套目录始终“不可见”。
立即学习“go语言免费学习笔记（深入）”；
- 启动时用
filepath.WalkDir(root, ...)遍历所有子目录，对每个d.IsDir() == true的路径调用watcher.Add(path) - 事件循环里监听
fsnotify.Create且event.IsDir() == true的事件，立即watcher.Add(event.Name) - 所有
watcher.Add()必须加锁（如sync.Mutex），否则并发调用会 panic：invalid memory address - Windows 下注意 OneDrive 或杀毒软件可能拦截底层
ReadDirectoryChangesW，导致事件丢失
fsnotify.Event.Name 的路径行为跨平台不一致，必须统一处理
fsnotify.Event.Name 是相对监听路径的，不是绝对路径。Linux/macOS 下可能是 /a/b/file.txt，Windows 下可能带盘符、反斜杠、大小写混乱——直接字符串比较或拼接容易出错。
常见坑：监听 "./data"，收到事件 Name 是 "file.log"，你再 os.Open("file.log") 就打开错了位置；或者用 strings.HasPrefix(event.Name, "tmp/") 在 Windows 上失效。
- 初始化监听前，用
filepath.Abs(root)转成绝对路径，后续所有路径操作基于这个基准 - 判断事件归属时，用
strings.HasPrefix(event.Name, "/")不可靠，改用filepath.Join(absRoot, event.Name)构造完整路径再操作 - 过滤逻辑（如忽略
node_modules）应放在事件处理侧，而不是靠Name字符串匹配——因为Name可能不含父级路径
资源和并发风险比想象中更早到来
每个 watcher.Add() 都对应一个独立的底层监听句柄（inotify 实例 / kqueue fd / Windows handle）。监听 1000 个子目录，就是 1000 个句柄——Linux 默认 inotify 限制常为 8192，但实际业务中很快撞上限；Windows 上句柄泄漏更隐蔽，表现为 CPU 占用缓慢爬升。
没人会在意第一次 Add() 成功就以为万事大吉，直到某天监控目录突然“失联”，查日志只有 too many open files。
- 启动时记录已添加路径数，超阈值（如 500）主动告警，而非硬扛
- 运行时新目录
Add()失败（too many open files）不要忽略，需清理旧监听或降级策略 - 避免监听整个
$HOME或/var/log这类天然高子目录数量的路径，优先按业务边界切分根目录 - 协程处理事件时，别在回调里做阻塞 I/O（如写数据库、发 HTTP 请求），攒批或投递到 worker channel
