Java WatchService 是基于系统通知机制的轻量高效文件监控方案，需三步实现：获取实例、注册目录路径（仅直接子项）、轮询并重置 WatchKey；支持递归监听需手动扩展。
Java 的 WatchService 是标准 API 中轻量、高效监控文件系统变更的方案，适用于监听目录下新增、修改、删除等事件。它基于操作系统底层通知机制（如 Linux inotify、Windows ReadDirectoryChangesW），不依赖轮询，资源开销低。
核心步骤：注册 + 轮询 + 处理
使用 WatchService 分三步：获取服务实例、注册目标路径、持续拉取并处理事件。
-
创建 WatchService 实例：
FileSystems.getDefault().newWatchService()，建议用 try-with-resources 管理生命周期 -
注册路径及监听类型：调用
path.register(watcher, ENTRY_CREATE, ENTRY_MODIFY, ENTRY_DELETE)；注意只能注册 目录，且仅监控其直接子项（不递归） -
阻塞式轮询事件：调用
watcher.take()获取WatchKey，再遍历其pollEvents()解析具体变更
关键细节：事件需手动重置 & 路径需规范化
每个 WatchKey 在消费后会变为“失效”状态，必须显式调用 key.reset() 才能继续接收后续事件；否则监听将中断。同时，注册路径应使用 toRealPath() 或 toAbsolutePath().normalize() 避免软链接或相对路径导致注册失败。
- 未调用
reset()→ 后续事件无法到达该 key，看似“失灵” - 注册了
./data但实际目录是符号链接 → 可能注册失败或监听错位 - 监听
/tmp时，/tmp/a/b.txt的修改不会触发事件（只响应/tmp下的直接变更）
处理常见事件类型的实用建议
事件类型对应明确语义，但需结合上下文判断真实意图。例如 ENTRY_MODIFY 可能是内容更新、属性变更或编辑器临时写入，建议配合文件最后修改时间或大小比对过滤噪声。
-
ENTRY_CREATE：新建文件或子目录；若为目录，可选择性对其递归注册（需自行实现） -
ENTRY_MODIFY：高频发生，适合做“文件保存完成”信号（如等待连续 2 秒无新 MODIFY 再触发构建） -
ENTRY_DELETE：文件/目录被移除；注意：移动出监听目录也触发 DELETE，移动进来则触发 CREATE
补充：简单递归监听的实现思路
WatchService 原生不支持递归，但可通过监听目录创建事件动态扩展。当收到 ENTRY_CREATE 且事件对象是目录时，立即对其调用 register()。需注意并发安全（如多线程同时创建嵌套目录），建议用 ConcurrentHashMap 缓存已注册路径，避免重复注册。
- 先注册根目录
- 在事件处理中识别新目录，立即注册其子路径
- 监听器退出前，遍历缓存 keys 并 cancel 清理
