watchservice是java nio.2提供的基于操作系统原生api（如inotify）的轻量级目录监控机制，支持entry_create、entry_modify、entry_delete等事件，但不递归监听子目录，需手动注册且必须调用key.reset()重置，否则无法接收新事件。
Java 中用 NIO 监视文件系统事件，核心就是 WatchService —— 它不是轮询，而是依赖操作系统底层通知（如 Linux 的 inotify、Windows 的 ReadDirectoryChangesW），所以响应快、资源省。
注册监听目录和事件类型
必须先获取一个 WatchService 实例，再把目标目录（Path）注册进去，并明确告诉它你关心哪些变化：
-
StandardWatchEventKinds.ENTRY_CREATE：新文件或子目录被创建、重命名 -
StandardWatchEventKinds.ENTRY_MODIFY：文件内容或元数据（如最后修改时间）被更改 -
StandardWatchEventKinds.ENTRY_DELETE：文件或子目录被删除 -
StandardWatchEventKinds.OVERFLOW：事件队列溢出，需做容错处理（比如日志告警）
注意：注册只对**当前目录**生效，默认不递归监听子目录。如需监控整个树形结构，得手动遍历所有子路径并逐个注册。
阻塞式获取事件并处理
通常用 watchService.take() 阻塞等待事件到来，拿到 WatchKey 后遍历其携带的事件列表：
- 每个事件的
event.context()返回的是相对路径（例如"report.txt"），需用directory.resolve(event.context())拼成完整路径 - 事件类型是枚举值，可直接用
==判断，不要用equals() - 处理完一轮事件后，必须调用
key.reset()；否则该键不会再触发新事件 - 如果
reset()返回false，说明监听已失效（比如目录被删、权限丢失），应退出循环
线程管理与资源释放
WatchService 是线程安全的，但监听逻辑一般放在独立线程中运行：
- 推荐设为守护线程（
thread.setDaemon(true)），避免阻塞 JVM 退出 - 主线程退出前，应主动调用
watchService.close()，否则可能泄露文件描述符或线程句柄 - 异常处理不能忽略
InterruptedException，要恢复中断状态：Thread.currentThread().interrupt()
常见坑点提醒
实际使用中容易踩的几个关键细节：
- Windows 下对符号链接（symlink）支持有限，部分事件可能不触发
- Linux 上单次
take()可能返回多个事件，但同一文件的多次修改可能合并为一个ENTRY_MODIFY，无法区分次数 - 移动（rename）操作在不同平台表现不一致：Linux 视为
DELETE + CREATE，macOS 可能只报MODIFY - 临时文件（如编辑器生成的 .swp 或 ~ 文件）频繁触发事件，建议在业务逻辑中过滤掉不需要的文件名模式
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
