Java NIO中walkFileTree遍历目录树的核心是Files.walkFileTree()配合SimpleFileVisitor子类，通过重写preVisitDirectory、visitFile、visitFileFailed、postVisitDirectory等方法处理事件，并用FileVisitResult控制流程。
Java NIO 中用 walkFileTree 遍历目录树，核心是调用 Files.walkFileTree() 方法，配合自定义的 SimpleFileVisitor 子类来处理文件、目录进入/退出、异常等事件。
基本用法：用 SimpleFileVisitor 快速实现遍历
最常用的方式是继承 SimpleFileVisitor<path></path>，重写需要响应的方法。它已为所有回调方法提供了空实现，你只需覆盖关心的几个即可：
-
preVisitDirectory：进入目录前触发（可用于过滤、统计） -
visitFile：访问每个普通文件时触发（最常用，比如打印路径、读取内容） -
visitFileFailed：访问文件失败时触发（如权限不足、路径不存在） -
postVisitDirectory：离开目录后触发（可用于清理或收尾）
示例：打印所有 .java 文件路径
Path start = Paths.get("/path/to/src");
Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
if (file.toString().endsWith(".java")) {
System.out.println(file);
}
return FileVisitResult.CONTINUE;
}
<pre class="brush:php;toolbar:false;">@Override
public FileVisitResult visitFileFailed(Path file, IOException exc) {
System.err.println("无法访问: " + file + ", 原因: " + exc.getMessage());
return FileVisitResult.CONTINUE; // 继续遍历其他路径
}});
立即学习“Java免费学习笔记（深入）”；
控制遍历行为：返回值决定流程走向
FileVisitResult 是关键控制开关，每个回调方法都必须返回它：
- CONTINUE：继续默认流程（最常用）
- TERMINATE：立即终止整个遍历（如找到目标文件后退出）
- SKIP_SUBTREE：跳过当前目录下的所有子目录（相当于剪枝）
- SKIP_SIBLINGS：跳过同级其他项（比如在 preVisitDirectory 中返回，会跳过该目录下所有文件和子目录）
示例：只遍历两层深，超过就跳过子目录
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
int maxDepth = 2;
Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
private int depth = 0;
<pre class="brush:php;toolbar:false;">@Override
public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) {
if (depth >= maxDepth) {
return FileVisitResult.SKIP_SUBTREE;
}
depth++;
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult postVisitDirectory(Path dir, IOException exc) {
depth--;
return FileVisitResult.CONTINUE;
}});
立即学习“Java免费学习笔记（深入）”；
使用 FileVisitor 接口实现更精细控制
如果需要同时响应多个事件并共享状态，或者想复用逻辑，可直接实现 FileVisitor<path></path> 接口。但注意：必须实现全部 4 个抽象方法，不能省略。
相比 SimpleFileVisitor，它更适合封装复杂策略，比如带路径匹配、大小过滤、并发处理的遍历器。
配合 FileFilter 或 Glob 模式做路径筛选
walkFileTree 本身不支持通配符过滤，但可在 visitFile 或 preVisitDirectory 中手动判断：
- 用
Path.getFileName().toString().matches(".*\.log")做正则匹配 - 用
Files.isRegularFile(path)确保是文件而非目录 - 用
GlobPattern.compile("*.txt").matcher(path.getFileName().toString()).matches()（需自行解析 glob） - 推荐搭配
Files.find()（Java 8+）做简单条件查找，它内部也基于 walkFileTree
例如：只处理最近 7 天修改的 .log 文件
long sevenDaysAgo = System.currentTimeMillis() - 7L * 24 * 60 * 60 * 1000;
Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
Path fileName = file.getFileName();
if (fileName != null && fileName.toString().endsWith(".log")) {
long lastModified = attrs.lastModifiedTime().toMillis();
if (lastModified >= sevenDaysAgo) {
System.out.println(file);
}
}
return FileVisitResult.CONTINUE;
}
}); 
