Files.walkFileTree()可安全高效遍历目录树，基于NIO.2 FileVisitor接口，自动处理符号链接、权限异常等；需传入起始Path和SimpleFileVisitor实现，重写preVisitDirectory、visitFile、visitFileFailed、postVisitDirectory四方法控制流程。
使用 Files.walkFileTree() 可以安全、高效地递归遍历整个目录树，它基于 NIO.2 的 FileVisitor 接口，能自动处理符号链接、权限异常、循环引用等边界情况，比手动递归更健壮。
核心用法：传入起始路径和自定义 FileVisitor
你需要实现 SimpleFileVisitor（推荐）或完整实现 FileVisitor 接口。最常用的是重写以下四个方法：
- preVisitDirectory：进入目录前调用（可用于过滤跳过某些目录）
- visitFile：访问普通文件时调用（核心逻辑放这里，比如打印路径、读取内容、匹配文件名）
- visitFileFailed：访问文件失败时调用（如无权限、文件被占用，可选择继续遍历）
- postVisitDirectory：离开目录后调用（可用于统计、清理资源）
一个实用示例：列出所有 .java 文件的绝对路径
下面代码会遍历指定根目录，只打印后缀为 .java 的文件路径：
Path start = Paths.get("/your/project/src");
Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
if (file.toString().endsWith(".java")) {
System.out.println(file.toAbsolutePath());
}
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult visitFileFailed(Path file, IOException exc) {
// 忽略无法访问的文件（如权限不足），继续遍历
return FileVisitResult.CONTINUE;
}
});
进阶技巧：控制遍历行为
你可以通过返回值精细控制流程：
- 返回
CONTINUE：继续遍历下一个条目 - 返回
SKIP_SIBLINGS：跳过当前目录下其余同级项（但不退出当前目录） - 返回
SKIP_SUBTREE：跳过当前目录的所有子目录（即不进入该目录） - 返回
TERMINATE：立即终止整个遍历
例如，在 preVisitDirectory 中判断目录名为 "target" 或 "node_modules"，直接返回 SKIP_SUBTREE 就能跳过构建产物目录，提升效率。
注意点与常见问题
使用时需留意几个关键细节：
- 路径对象是
Path类型，不是String；建议用Paths.get(...)创建 - 默认不跟随符号链接；如需跟随，要显式传入
FileVisitOption.FOLLOW_LINKS - 遇到 I/O 异常（如磁盘断开）会抛出
IOException，应在外层 try-catch - 遍历过程是单线程同步执行，如需并发处理，请配合线程池 +
visitFile中提交任务
