Files.walk用于遍历目录，返回Stream<Path>，支持深度控制、文件过滤和异常处理，结合try-with-resources确保资源释放，适用于搜索文件、统计或删除操作。
在Java中，Files.walk 是一个非常实用的方法，用于遍历指定目录下的所有文件和子目录。它基于NIO.2（New I/O 2）引入的 java.nio.file 包，提供了更强大、更安全的文件操作能力。
理解 Files.walk 的基本用法
Files.walk 返回一个 Stream<Path>，可以按深度优先顺序遍历目录树。你只需要传入一个起始路径，就可以轻松访问所有子项。
例如，遍历某个目录并打印所有路径：
import java.nio.file.*;
import java.io.IOException;
public class FileWalker {
public static void main(String[] args) {
Path start = Paths.get("C:\example\dir");
try (Stream<Path> stream = Files.walk(start)) {
stream.forEach(System.out::println);
} catch (IOException e) {
System.err.println("访问目录时出错：" + e.getMessage());
}
}
}
这段代码会输出目录及其所有子目录中的每一个文件和文件夹路径。
立即学习“Java免费学习笔记（深入）”；
限制遍历深度
如果你不希望递归太深，可以使用重载方法 Files.walk(Path start, int maxDepth) 来控制层级。
比如只遍历两层目录：
try (Stream<Path> stream = Files.walk(start, 2)) {
stream.forEach(path -> System.out.println("文件：" + path));
} catch (IOException e) {
e.printStackTrace();
}
这样能避免进入过深的嵌套结构，提升性能或满足特定需求。
结合 Files.isRegularFile 过滤文件
通常我们只想处理真实文件，而不是目录。可以结合 Files.isRegularFile 方法进行过滤。
示例：只列出普通文件：
try (Stream<Path> stream = Files.walk(start)) {
stream.filter(Files::isRegularFile)
.forEach(path -> System.out.println("发现文件：" + path.getFileName()));
} catch (IOException e) {
System.err.println("读取失败：" + e.getMessage());
}
这里用了方法引用 Files::isRegularFile 来判断是否为常规文件，排除目录本身。
跳过访问被拒绝的目录
某些系统目录可能因权限问题导致抛出异常。为了保证遍历继续执行，可以在流处理中捕获异常或提前检查可读性。
改进方式：添加异常处理与判断：
try (Stream<Path> stream = Files.walk(start)) {
stream.filter(path -> {
try {
return Files.isRegularFile(path);
} catch (SecurityException | IOException e) {
return false;
}
}).forEach(System.out::println);
} catch (IOException e) {
System.err.println("无法开始遍历：" + e.getMessage());
}
这样即使遇到无权限访问的路径，程序也不会中断。
实际应用场景建议
- 搜索特定后缀文件（如 .log、.txt），可用 path.toString().endsWith(".log") 配合 filter。
- 统计文件数量或总大小时，用 mapToInt(Path::getNameCount) 或 Files.size(path)。
- 删除临时文件前先用 walk 扫描确认目标范围，防止误删。
注意：每次使用 Files.walk 后务必关闭流资源 —— 使用 try-with-resources 是最佳实践。
基本上就这些。掌握 Files.walk 能让你在处理复杂目录结构时更加灵活高效。合理搭配过滤、映射和异常处理，就能写出稳定可靠的文件扫描逻辑。
