filevisitresult 是 nio.2 遍历控制核心，含 continue、skip_siblings、skip_subtree、terminate 四值：continue 继续默认遍历；skip_siblings 跳出当前层级访问上层兄弟；skip_subtree 仅 previsitdirectory 有效，跳过子树；terminate 立即终止整个遍历。
FileVisitResult 是 NIO.2 中控制遍历流程的核心开关，它不决定“做什么”，而是决定“接下来往哪走”。用好它，就能在遍历中精准跳过无关目录、提前终止搜索、或避开权限异常区域。
理解四个返回值的实际行为
每个 FileVisitor 方法（如 preVisitDirectory、visitFile）返回一个 FileVisitResult 枚举值，walkFileTree 根据该值动态调整后续访问路径：
- CONTINUE：按默认顺序继续——访问下一个同级项（文件或子目录），再深入子树（如果当前是目录）
- SKIP_SIBLINGS：立刻跳出当前层级，返回上一级后访问其下一个兄弟节点；当前目录的其他子项和同级文件/目录全部跳过
- SKIP_SUBTREE：仅对 preVisitDirectory 有效；表示不进入该目录内部，但会继续处理它的兄弟节点
- TERMINATE：立即中止整个 walkFileTree 调用，不再访问任何后续节点
在 preVisitDirectory 中控制子目录进入逻辑
这是最常用的跳转控制点。比如你想跳过所有名为 temp 或含 .git 的目录：
示例：
@Override
public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
String name = dir.getFileName().toString();
if ("temp".equals(name) || ".git".equals(name)) {
System.out.println("跳过目录：" + dir);
return FileVisitResult.SKIP_SUBTREE; // 不进这个目录，但继续遍历同级其他目录
}
System.out.println("进入目录：" + dir);
return FileVisitResult.CONTINUE;
}
用 SKIP_SIBLINGS 实现“只处理第一个匹配目录”
当你找到目标目录后，不想再检查同级其他目录（比如配置目录只认 conf，不看 config 或 cfg）：
- 在 preVisitDirectory 中判断匹配成功，返回 SKIP_SIBLINGS
- walkFileTree 会直接结束当前层级遍历，返回上层并尝试访问上层的下一个兄弟（若存在）；但通常你已在目标目录内完成操作，可配合 TERMINATE 更早收手
结合 visitFileFailed 做容错式跳转
遇到无权限或损坏路径时，默认行为可能中断或报错。合理使用返回值能保持遍历韧性：
- 返回 CONTINUE：跳过该失败项，继续后续节点（最常用）
- 返回 SKIP_SUBTREE：仅在 visitFileFailed 中调用无效；它只对 preVisitDirectory 生效
- 若某类错误意味着整块区域不可用（如挂载点失效），可在该方法中抛出异常或记录后仍返回 CONTINUE，避免雪崩
注意返回值生效范围的边界
不同方法返回同一枚举，效果不同：
- SKIP_SUBTREE 在 visitFile 或 visitFileFailed 中返回——会被忽略，无实际作用
- SKIP_SIBLINGS 在 postVisitDirectory 中返回——不会跳过兄弟目录，因为兄弟早已访问完毕
- 只有 preVisitDirectory 支持完整跳转语义（SKIP_SUBTREE / SKIP_SIBLINGS），这是设计使然
