Java中WatchService通过注册目录、轮询事件、解析ENTRY_CREATE/DELETE/MODIFY类型实现高效监听，基于OS原生机制（如inotify），需手动递归注册子目录、调用reset()重置键、resolve()拼接绝对路径，并注意事件丢失与跨平台差异。
Java 中使用 WatchService 实时监听文件变动，核心在于注册路径、轮询事件、解析类型并及时处理。它基于操作系统底层的文件系统通知机制（如 Linux 的 inotify、Windows 的 ReadDirectoryChangesW），轻量高效，但需注意线程阻塞、事件丢失和路径注册限制等细节。
创建 WatchService 并注册监控路径
先通过 FileSystems.getDefault().newWatchService() 获取服务实例，再对目标目录调用 register() 方法，指定要监听的事件类型：
-
StandardWatchEventKinds.ENTRY_CREATE：新建文件或子目录 -
StandardWatchEventKinds.ENTRY_DELETE：删除文件或子目录 -
StandardWatchEventKinds.ENTRY_MODIFY：文件内容或元数据变更（注意：Linux 下修改内容常触发多次 MODIFY，Windows 下可能合并）
⚠️ 只能注册**已存在的目录**；子目录不会自动递归监听，需手动遍历注册；符号链接默认不追踪目标内容。
用 while 循环持续获取并处理事件
WatchService.take() 是阻塞方法，直到有事件到达才返回 WatchKey；也可用 poll() 或 poll(timeout, unit) 避免永久阻塞：
立即学习“Java免费学习笔记（深入）”；
- 每个
WatchKey对应一次注册路径的批量事件 - 调用
key.pollEvents()获取事件列表，遍历处理 - 处理完必须调用
key.reset()，否则该 key 不再接收新事件 - 若
reset()返回false，说明路径已不可访问（如被删除或权限变更），应退出监听
正确提取事件中的文件名与路径
事件的 context() 返回的是 Path 类型的**相对路径**（相对于注册目录），不是绝对路径：
- 例如注册了
/home/user/docs，新增文件/home/user/docs/report.txt，事件 context 是report.txt - 需用注册时的原始
Path调用resolve(context)拼出完整路径 - 不要直接 toString() 事件 context，避免跨平台路径分隔符问题
常见坑与实用建议
WatchService 简洁但易踩坑：
- 事件可能丢失：高频写入（如日志滚动）时，多个操作可能合并为一个 MODIFY；关键场景建议结合文件校验（如最后修改时间 + 文件大小）做二次确认
- 不监听重命名后的文件：
mv a.txt b.txt触发ENTRY_DELETE（a.txt）和ENTRY_CREATE（b.txt），但无法知道二者关联 - Windows 下对网络驱动器支持不稳定；macOS 使用 kqueue，行为略有差异
- 建议搭配守护线程使用，并在 JVM 关闭前调用
watchService.close()
