推荐使用 Files.walk() 遍历目录,它返回 Stream 支持函数式操作、默认不跟随符号链接;可通过 depth 参数限制深度;复杂场景用 SimpleFileVisitor 实现细粒度控制;配合 filter 可按扩展名、权限、时间等条件筛选。

Java 中用 NIO 遍历指定目录下的所有文件,推荐使用 Files.walk() —— 它是 NIO.2 提供的简洁、安全、支持深度控制的遍历方式。
用 Files.walk() 递归遍历全部文件
这是最常用也最推荐的方式。它返回一个 Stream<path></path>,天然支持函数式操作,且自动处理符号链接(默认不跟随,避免循环):
import java.io.IOException;
import java.nio.file.*;
import java.util.stream.Stream;
<p>Path startDir = Paths.get("/path/to/dir");</p><p>try (Stream<path> paths = Files.walk(startDir)) {
paths
.filter(Files::isRegularFile) // 只保留普通文件(跳过目录、链接等)
.forEach(System.out::println);
} catch (IOException e) {
e.printStackTrace();
}</path></p>
限制遍历深度防止过深或失控
如果只想查两层子目录,或避免遍历巨型目录,可用带 depth 参数的重载方法:
-
Files.walk(startDir, maxDepth):最多向下遍历 maxDepth 层(根目录算第 0 层) - 例如
Files.walk(dir, 2)会包含 dir、其子目录、子目录的子目录中的所有条目,但不会进入更深层
用 SimpleFileVisitor 做细粒度控制
当需要在遍历中做复杂逻辑(如跳过某些目录、统计大小、捕获异常、提前终止),更适合继承 SimpleFileVisitor:
Files.walkFileTree(startDir, new SimpleFileVisitor<path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
if (Files.isRegularFile(file)) {
System.out.println("文件: " + file);
}
return FileVisitResult.CONTINUE;
}
<pre class="brush:php;toolbar:false;">@Override
public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) {
// 可在此判断是否跳过某个目录,例如:
if (dir.toString().contains("target")) {
return FileVisitResult.SKIP_SUBTREE;
}
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult visitFileFailed(Path file, IOException exc) {
System.err.println("访问失败: " + file + " - " + exc.getMessage());
return FileVisitResult.CONTINUE; // 继续遍历其他路径
}});
注意路径匹配与过滤技巧
结合 Files.find() 或流式过滤,可高效按名称、扩展名、修改时间等条件筛选:
- 查所有 .java 文件:
Files.walk(dir).filter(p -> p.toString().endsWith(".java")) - 配合
Files.isReadable()过滤不可读文件 - 用
Files.getLastModifiedTime(p)结合Instant.now().minusDays(7)找一周内修改的文件
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











