使用 Files.walk 可遍历目录及子目录，返回 Stream<Path> 支持函数式操作；通过设置深度参数限制层级，filter 过滤文件类型，结合 FOLLOW_LINKS 处理符号链接，适用于文件搜索与批量处理。
使用 Java 中的 Files.walk 方法可以轻松遍历目录及其子目录中的所有文件和子目录。这个方法返回一个 Stream<Path>，支持函数式编程操作，比如过滤、映射和收集结果。
基本用法：遍历所有文件和目录
下面是一个简单的例子，展示如何使用 Files.walk 遍历指定目录下的所有条目（包括子目录中的）：
import java.nio.file.*;
import java.io.IOException;
import java.util.stream.Stream;
public class DirectoryWalker {
public static void main(String[] args) {
Path startDir = Paths.get("C:\example");
try (Stream<Path> walk = Files.walk(startDir)) {
walk.forEach(System.out::println);
} catch (IOException e) {
System.err.println("访问目录时出错：" + e.getMessage());
}
}
}
这段代码会打印出从 startDir 开始的所有文件和目录路径。
限制遍历深度
如果只想遍历特定层级的子目录，可以传入一个最大深度参数。例如，只遍历当前目录和一级子目录：
立即学习“Java免费学习笔记（深入）”；
try (Stream<Path> walk = Files.walk(startDir, 2)) { // 深度为2：起始目录 + 一层子目录
walk.forEach(System.out::println);
} catch (IOException e) {
System.err.println("错误：" + e.getMessage());
}
第二个参数是整数类型，表示最大递归层级。值为1时仅列出起始目录内容，不深入子目录。
只列出文件或过滤特定类型
通常我们只关心文件，或者想筛选特定扩展名。可以通过 filter() 方法实现：
try (Stream<Path> walk = Files.walk(startDir)) {
walk.filter(Files::isRegularFile) // 只保留普通文件
.filter(path -> path.toString().endsWith(".txt"))
.forEach(System.out::println);
} catch (IOException e) {
System.err.println("读取失败：" + e.getMessage());
}
上面代码只输出所有 .txt 文件。你也可以根据需要改成 .log、.java 等其他扩展名。
处理符号链接与异常
Files.walk 默认会跟随符号链接，但如果遇到循环链接可能会抛出异常。为了更安全地处理异常情况，可以使用 walk(Path, FileVisitOption...) 形式：
try (Stream<Path> walk = Files.walk(startDir, FileVisitOption.FOLLOW_LINKS)) {
walk.filter(Files::isRegularFile)
.forEach(System.out::println);
} catch (IOException e) {
System.err.println("IO异常：" + e.getMessage());
}
</font>
注意：使用 FOLLOW_LINKS 要小心无限循环的风险。在大多数情况下，默认行为已经足够安全。
基本上就这些。Files.walk 简洁高效，结合 Stream API 能快速完成各种文件扫描任务，比如查找日志文件、统计文件数量或批量处理资源文件。
