Java中FileVisitor遍历目录树的核心是Files.walkFileTree()配合自定义访问器，实现深度优先、安全可控的遍历；其接口含preVisitDirectory、visitFile、visitFileFailed、postVisitDirectory四个关键回调方法，分别对应目录进入前、文件访问时、访问失败时、目录退出后四种状态。
Java 中使用 FileVisitor 遍历目录树，核心是借助 Files.walkFileTree() 方法配合自定义的访问器实现深度优先、安全可控的遍历，比递归调用 File.listFiles() 更健壮，天然支持符号链接处理、异常中断和细粒度控制。
FileVisitor 接口的关键方法说明
FileVisitor 是一个泛型接口（FileVisitor），主要定义四个回调方法，分别对应遍历过程中的不同节点状态：
-
preVisitDirectory(T dir, BasicFileAttributes attrs)：进入目录前调用，返回值决定是否继续遍历该目录（
CONTINUE、SKIP_SUBTREE、TERMINATE） - visitFile(T file, BasicFileAttributes attrs)：访问普通文件时调用，适合做文件内容检查、复制、删除等操作
- visitFileFailed(T file, IOException exc)：访问文件失败时调用（如权限不足、路径不存在），可选择忽略或中止
- postVisitDirectory(T dir, IOException exc)：退出目录后调用（无论成功与否），适合做清理或统计收尾工作
快速实现一个基础遍历器
最简方式是继承 SimpleFileVisitor —— 它已为所有方法提供了默认返回 CONTINUE 的实现，只需重写关心的方法即可：
Files.walkFileTree(Paths.get("/home/user/docs"), new SimpleFileVisitor() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
if (file.toString().endsWith(".log")) {
System.out.println("找到日志文件：" + file);
}
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult visitFileFailed(Path file, IOException exc) {
System.err.println("跳过无法访问的文件：" + file + "，原因：" + exc.getMessage());
return FileVisitResult.CONTINUE; // 继续遍历其他文件
}
});
控制遍历行为的实用技巧
通过返回特定枚举值，可在运行时动态调整遍历逻辑：
立即学习“Java免费学习笔记（深入）”；
- 想跳过某个目录及其全部子内容？在
preVisitDirectory中判断目录名，返回SKIP_SUBTREE - 遇到严重错误（如磁盘 I/O 异常）需立即停止？在任意方法中返回
TERMINATE - 需要统计文件/目录数量？在
visitFile和preVisitDirectory中用外部变量累加（注意多线程下需同步） - 想安全处理符号链接？创建
FileVisitor时传入EnumSet.of(FileVisitOption.FOLLOW_LINKS)作为 walkFileTree 的第二个参数
与传统递归遍历的对比优势
相比手写递归 + File.listFiles()：
- 自动处理空目录、权限异常、循环软链等边界情况
- 无需手动管理栈或递归深度，避免
StackOverflowError - 每个访问步骤都可精确拦截和干预，便于审计、限速、过滤
- 基于 NIO.2，底层更贴近操作系统语义，性能与可靠性更优
基本上就这些。掌握这四个回调的触发时机和返回含义，就能写出清晰、健壮、可扩展的目录遍历逻辑。
