Files.walkFileTree 是 Java NIO.2 提供的高效安全目录递归遍历工具，通过 SimpleFileVisitor 四个回调方法（preVisitDirectory、visitFile、visitFileFailed、postVisitDirectory）精细控制流程，支持异常处理、符号链接跟随、深度限制与路径匹配，避免栈溢出并提升性能。
Files.walkFileTree 是 Java NIO.2 提供的高效、安全、可定制的目录递归遍历工具，特别适合处理含符号链接、权限异常、循环引用或深层嵌套的复杂目录树。它不依赖递归调用栈，避免 StackOverflowError，还能精细控制遍历行为（如跳过子目录、捕获异常、过滤路径）。
核心：使用 SimpleFileVisitor 定制遍历逻辑
Files.walkFileTree 接收一个起始路径和一个 FileVisitor 实例（通常继承 SimpleFileVisitor），通过重写其四个回调方法控制流程：
- preVisitDirectory：进入目录前触发 —— 可用于判断是否继续遍历（返回 SKIP_SUBTREE 跳过该目录）、检查访问权限、记录深度
- visitFile：访问普通文件时触发 —— 最常用，适合匹配文件名、检查内容、统计大小、收集路径
- visitFileFailed：访问文件失败时触发（如无权限、路径不存在）—— 必须重写才能捕获并处理 IOException，否则遍历会中断
- postVisitDirectory：离开目录后触发 —— 适合资源清理、汇总子目录结果、检测空目录
查找特定文件：支持通配符与正则的灵活匹配
不要在 visitFile 中硬编码字符串比较。推荐结合 Path.getFileName() 和 String.startsWith/endsWith/contains，或用 java.util.regex.Pattern 做正则匹配。例如查找所有 .log 结尾且文件名含 "error" 的文件：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
String name = file.getFileName().toString();
if (name.endsWith(".log") && name.contains("error")) {
System.out.println("找到错误日志：" + file);
// 可添加到 List<Path> results 中收集
}
return FileVisitResult.CONTINUE;
}
安全遍历复杂目录：处理异常、循环、权限与深度限制
真实环境常遇到 PermissionDeniedException、FileSystemLoopException（符号链接成环）、超深目录等。正确做法是：
立即学习“Java免费学习笔记（深入）”；
- 重写 visitFileFailed：对 AccessDeniedException 返回 CONTINUE（跳过该条目，继续遍历）；对其他异常可选择打印日志后 CONTINUE 或 TERMINATE
- 启用符号链接跟随（需显式传入 EnumSet.of(FileVisitOption.FOLLOW_LINKS)），但注意配合 FileSystemLoopException 处理
- 在 preVisitDirectory 中用 path.getNameCount() 计算当前深度，超限时返回 SKIP_SUBTREE 防止无限深入
实用技巧：提前终止、路径过滤与性能提示
不需要遍历全部时，可在任意回调中返回 FileVisitResult.TERMINATE 立即退出；若只需搜索前 N 个匹配项，用外部计数器控制；另外注意：
- 避免在 visitFile 中执行耗时 I/O（如读取大文件内容）—— 先收集路径，再批量处理
- 路径过滤建议放在 visitFile 内部，而非预过滤 Files.walk() 流（后者仍会遍历所有节点）
- 如需获取文件属性（大小、修改时间），直接使用参数中的 BasicFileAttributes attrs，比额外调用 Files.size() 更高效
