Files.find 是 Java 7 提供的递归遍历目录并按谓词筛选文件/目录的 Stream 方法，需指定起始路径、最大深度和接收 Path 与 BasicFileAttributes 的匹配谓词，使用时须 try-with-resources 管理资源。
Files.find 是 Java 7 引入的 java.nio.file.Files 类中的一个静态方法，用于**递归遍历目录树并按条件筛选文件或目录**。它返回一个 Stream<path></path>，支持函数式编程风格的过滤、映射等操作。
基本用法：指定起始路径、深度和匹配谓词
方法签名如下：
public static Stream参数说明：
- start：起始目录路径（必须存在且为目录）
- maxDepth：最大遍历深度（0 表示只检查起始路径自身；1 表示起始目录 + 其直接子项；Integer.MAX_VALUE 表示无限深度）
-
matcher：双参数谓词，接收当前路径
Path和其属性BasicFileAttributes，返回true表示匹配（即保留该路径）
常见筛选场景与写法
✅ 查找所有 .txt 文件（不区分大小写）
立即学习“Java免费学习笔记（深入）”；
try (Stream<Path> stream = Files.find(Paths.get("/home/user/docs"),
Integer.MAX_VALUE,
(path, attrs) -> !attrs.isDirectory() &&
path.toString().toLowerCase().endsWith(".txt"))) {
stream.forEach(System.out::println);
}✅ 查找最近 7 天内修改的普通文件
long oneWeekAgo = System.currentTimeMillis() - 7L * 24 * 60 * 60 * 1000;
try (Stream<Path> stream = Files.find(Paths.get("/var/log"),
Integer.MAX_VALUE,
(path, attrs) -> !attrs.isDirectory() &&
attrs.lastModifiedTime().toMillis() >= oneWeekAgo)) {
stream.forEach(System.out::println);
}✅ 查找大于 1MB 的文件
try (Stream<Path> stream = Files.find(Paths.get("/tmp"),
Integer.MAX_VALUE,
(path, attrs) -> !attrs.isDirectory() && attrs.size() > 1_048_576)) {
stream.forEach(System.out::println);
}注意事项与最佳实践
-
必须关闭 Stream：
Files.find返回的 Stream 是资源敏感型（底层打开文件系统句柄），务必用try-with-resources确保释放，否则可能引发IOException或句柄泄漏 -
异常处理：方法声明抛出
IOException，但实际在 lambda 中无法直接 throw 检查异常；如需处理访问拒绝等异常，建议配合Files.walkFileTree自定义FileVisitor -
性能提示：
maxDepth设得太大会降低效率；若只需一级子项，用Files.list()+filter更轻量 -
路径判断优先用属性：比如判断是否为文件，用
!attrs.isDirectory()比Files.isRegularFile(path)更高效（避免额外系统调用）
替代方案对比：Files.walk vs Files.find
Files.walk() 返回 Stream<path></path>，但不带属性；若需文件属性，每次都要调用 Files.readAttributes()，开销更大。而 Files.find 在遍历时已获取 BasicFileAttributes，适合依赖元数据的筛选，更简洁高效。
