要通过NIO.2的WatchService实时监听文件系统事件，需正确注册路径、解析WatchEvent类型与context相对路径并resolve为绝对路径，注意单层监听、跨文件系统限制、事件丢失及MODIFY语义模糊等问题。
要通过NIO.2的WatchService机制实时感知文件系统中创建、删除、修改等事件，关键在于正确注册监听路径、准确解析WatchEvent类型与上下文，并处理可能的事件丢失或重复问题。
注册监听并启动事件循环
使用FileSystems.getDefault().newWatchService()获取服务实例，对目标目录调用register()，指定StandardWatchEventKinds中的事件类型：
-
ENTRY_CREATE：捕获新建文件或子目录 -
ENTRY_DELETE：捕获删除操作（含重命名移出） -
ENTRY_MODIFY：捕获内容或元数据变更（如写入、截断、chmod、touch）
注意：注册仅作用于**单层目录**，不递归；若需监控子树，需遍历目录手动为每个子目录注册，或结合Files.walkFileTree()实现。
可靠提取事件信息
从WatchKey.poll()或.take()获取WatchKey后，遍历其pollEvents()列表。每个WatchEvent>包含三部分：
-
event.kind()：返回具体事件类型（如StandardWatchEventKinds.ENTRY_MODIFY） -
event.context()：返回Path对象，表示相对于注册路径的**相对路径**（例如注册/home/user，新建/home/user/doc.txt，则context为doc.txt） -
event.count()：同一事件在短时间内多次触发时的累计次数（如快速保存可能触发多个MODIFY）
务必用注册时的根路径resolve()拼接context()，才能得到完整绝对路径。
应对常见陷阱
NIO.2的WatchService在不同OS上行为有差异，需主动规避：
- 事件丢失：Linux（inotify）和Windows（ReadDirectoryChangesW）均有缓冲区限制。一旦队列满，后续事件被丢弃且不报错。建议缩短事件处理时间，或定期检查目录快照作兜底
- MODIFY语义模糊：一个文件保存可能触发多次MODIFY（如编辑器先写临时文件再重命名）。应结合CREATE+DELETE+MODIFY序列判断真实意图，或对高频路径加去抖（如100ms内合并同文件的多次MODIFY）
- 跨文件系统失效：注册路径与监听目标必须在同一挂载点。移动文件到另一分区会触发DELETE而非MODIFY
轻量级实用示例
以下代码片段聚焦核心逻辑，省略异常处理和资源关闭：
WatchService watcher = FileSystems.getDefault().newWatchService();
Path dir = Paths.get("/tmp/monitor");
dir.register(watcher,
StandardWatchEventKinds.ENTRY_CREATE,
StandardWatchEventKinds.ENTRY_DELETE,
StandardWatchEventKinds.ENTRY_MODIFY);
while (true) {
WatchKey key = watcher.take(); // 阻塞等待
for (WatchEvent<?> event : key.pollEvents()) {
Path context = (Path) event.context();
Path fullPath = dir.resolve(context);
switch (event.kind()) {
case ENTRY_CREATE:
System.out.println("Created: " + fullPath);
break;
case ENTRY_DELETE:
System.out.println("Deleted: " + fullPath);
break;
case ENTRY_MODIFY:
System.out.println("Modified: " + fullPath);
break;
}
}
if (!key.reset()) break; // 重置失败说明目录已不可访问
}
不复杂但容易忽略细节——真正落地时，往往需要配合路径规范化、事件去重、异常恢复重连，才能稳定用于生产环境。
