FileVisitResult是Java NIO.2中控制Files.walkFileTree()遍历走向的唯一机制，仅决定“往哪走”：CONTINUE推进层级或兄弟节点，SKIP_SUBTREE在preVisitDirectory中跳过整棵子树，SKIP_SIBLINGS跳出同级遍历，TERMINATE立即终止全部遍历。
FileVisitResult 是 Java NIO.2 中控制 Files.walkFileTree() 遍历流程的唯一出口，它不改变遍历顺序，也不决定“做什么”，只决定“接下来往哪走”。在处理海量文件目录时，合理使用它能显著提升效率、规避异常、减少无效 I/O。
CONTINUE：默认继续，但隐含层级推进逻辑
这是最常用也最容易被误解的返回值。它不代表“无脑往下走”，而是在当前遍历机制下按既定路径推进：
- 在
preVisitDirectory中返回 CONTINUE：表示进入该目录，先处理其第一个子项（可能是文件或子目录），再递归深入 - 在
visitFile或postVisitDirectory中返回 CONTINUE：表示继续处理当前层级的下一个兄弟节点（同级文件或目录） - 在
visitFileFailed中返回 CONTINUE：跳过失败项，继续后续节点——这对海量目录中偶发的权限拒绝、符号链接损坏等场景至关重要，避免整棵树中断
SKIP_SUBTREE：精准剪枝，大幅降低遍历开销
该值仅在 preVisitDirectory 中有效，是应对海量目录的核心优化手段：
- 匹配构建产物目录（如
target、build、out）、缓存目录（如.gradle、node_modules）、版本控制元数据（如.git、.svn）时，直接返回 SKIP_SUBTREE - 效果是跳过整个子树的所有文件和子目录，不触发任何
visitFile或嵌套preVisitDirectory回调，I/O 和 CPU 开销趋近于零 - 注意：它不影响同级其他目录——比如跳过
project/target后，仍会继续访问project/src和project/docs
SKIP_SIBLINGS 与 TERMINATE：用于定向搜索与快速收口
当目标明确（如找第一个 application.yml、定位唯一 MANIFEST.MF），无需遍历全量时，这两个值可提前终止冗余路径：
立即学习“Java免费学习笔记（深入）”；
-
SKIP_SIBLINGS 在
preVisitDirectory中生效：找到目标目录（如src/main/resources）后立即跳出该层，不再检查同级的src/test/resources等；walkFileTree 会回退至上层并尝试访问其下一个兄弟 -
TERMINATE 可在任意回调中返回：一旦确认命中目标（例如在
visitFile中发现所需文件），立刻终止整个遍历，不等待队列清空或层级回溯 - 二者常组合使用：先用 SKIP_SIBLINGS 收窄范围，再用 TERMINATE 彻底退出，避免多一层无谓的父级遍历
广度优先场景下 FileVisitResult 完全不参与
需特别注意：Files.walkFileTree() 固定为深度优先，且不可配置。若你自行用 Queue + 循环实现广度优先（如逐层扫描 level 0 → level 1 → level 2）：
- 你根本不会传入
FileVisitor，FileVisitResult没有调用入口，所有枚举值均无效 - 跳过子目录、终止遍历等逻辑需由你手动控制队列添加与循环退出，与 NIO.2 的这套枚举机制无关
- 海量目录下 BFS 更易内存溢出（需缓存大量路径），而 DFS +
SKIP_SUBTREE天然更省内存，通常更实用
