监听目录前必须确认路径存在且可读，先用os.stat检查目录存在性与类型，解析符号链接，避免监听空字符串或递归问题；需手动遍历子目录并逐个添加监听；注意原子写入导致的rename事件、临时文件过滤、channel消费阻塞及跨平台差异。
监听目录前必须确认路径存在且可读
直接调用 watcher.Add("audit/logs") 很可能静默失败——Linux/macOS 下返回 nil 错误，Windows 下甚至 panic。这不是 bug，而是底层 inotify/FSEvents 要求路径真实存在且进程有读权限。
- 先做
os.Stat("audit/logs")，检查err == nil && info.IsDir() - 若路径是符号链接，用
filepath.EvalSymlinks("audit/logs")解析真实路径再监听，否则监听的是链接本身 - 绝对不要监听
""、"."或".."，各平台行为不一致，macOS 会直接报错
递归监听子目录必须手动遍历，不能靠 fsnotify 自动处理
fsnotify.Watcher.Add() 从不递归。监听 "audit/" 只能捕获该目录自身的重命名或删除，对 audit/2026/06/access.log 的修改完全无感。
- 用
filepath.WalkDir("audit/", ...)遍历所有子目录，对每个os.DirEntry调用watcher.Add(entry.Name()) - 跳过符号链接：
if entry.Type() & os.ModeSymlink != 0，避免循环或权限拒绝 - Linux 下注意系统限制：
/proc/sys/fs/inotify/max_user_watches，超限会报too many open files，需调高该值
编辑器保存后收不到 Write 事件？大概率是原子写入 + 事件类型判断错误
Vim、VS Code 默认启用原子写入：先写 access.log~ 或 .access.log.tmp，再 rename 覆盖原文件。原 inode 失效，Write 事件根本不会触发在目标路径上。
- 必须同时监听
fsnotify.Write和fsnotify.Rename，且优先响应后者：if event.Op&fsnotify.Rename != 0 && filepath.Base(event.Name) == "access.log" - 过滤临时文件：
strings.HasSuffix(event.Name, "~")、strings.HasSuffix(event.Name, ".tmp")、strings.HasSuffix(event.Name, ".swp") - 收到事件后立刻
os.Stat(event.Name)，确认文件存在、大小非零，避免处理残留临时文件
Events 和 Errors channel 不持续消费会导致 watcher 卡死
watcher.Events 和 watcher.Errors 都是无缓冲 channel。没人读，写入就会阻塞整个 watcher —— 新事件进不来，后续所有监听失效。
- 必须用 goroutine 持续读取：
go func() { for range watcher.Events { ... } }() - 永远用
event.Has(fsnotify.Write)判断，而非event.Op == fsnotify.Write，因为事件可能含多个 flag（如Write | Chmod） - 关闭 watcher 前，先停止自己的消费 goroutine，再调
watcher.Close()；关闭后仍需读完 channel 中最多 1 个残留事件，否则可能 panic
Chmod 事件泛滥和 FSEvents 对原子写入的延迟响应——它常把一次保存拆成 Create + Write 两个事件，中间间隔几十毫秒，且不保证顺序。这时仅靠 filepath.Base() 过滤不够，得结合 os.Stat() 比较 mtime 和 size 才能确认是否为有效变更。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
