Java如何读取一个文件夹下的所有文件路径？

Java读取文件夹的基本方法

在Java中，读取文件夹内容主要通过java.io.File类和java.nio.file包（Java 7及以上版本）实现，两种方式各有优劣：File类操作简单，适合基础需求；NIO（New I/O）功能更强大，支持高效文件操作和异步IO，以下是具体实现方式。

使用java.io.File类读取文件夹

File类是Java中传统的文件操作类，通过其提供的方法可以轻松获取文件夹下的文件和子目录信息。

初始化File对象

需创建一个File对象，传入文件夹的路径，路径可以是绝对路径或相对路径：

File folder = new File("D:/example"); // 绝对路径
File folder = new File("src/main/resources"); // 相对路径（项目根目录为基准）

若路径中包含特殊字符或需要跨平台兼容，建议使用File.separator或Paths.get()（NIO方式）处理路径分隔符。

判断路径是否为目录

在操作前，需确认路径是否指向一个有效的目录，避免因路径错误导致异常：

if (!folder.exists()) {
    System.out.println("文件夹不存在");
} else if (!folder.isDirectory()) {
    System.out.println("路径不是文件夹");
}

获取文件夹下的文件和子目录

File类提供了list()和listFiles()方法用于获取目录内容：

• list()：返回String[]，仅包含文件和子目录的名称（不含路径）。
• listFiles()：返回File[]，返回包含完整路径的File对象，更常用。

示例代码：

File[] files = folder.listFiles();
if (files != null) {
    for (File file : files) {
        if (file.isFile()) {
            System.out.println("文件: " + file.getName());
        } else if (file.isDirectory()) {
            System.out.println("子目录: " + file.getName());
        }
    }
}

递归读取子目录

若需读取文件夹及其所有子目录下的文件（即深度遍历），可通过递归实现：

public static void listFilesRecursively(File folder) {
    File[] files = folder.listFiles();
    if (files != null) {
        for (File file : files) {
            if (file.isDirectory()) {
                listFilesRecursively(file); // 递归调用
            } else {
                System.out.println("文件路径: " + file.getAbsolutePath());
            }
        }
    }
}

过滤文件和目录

listFiles()方法支持传入FilenameFilter或FileFilter接口实现，用于筛选特定条件的文件或目录，仅获取.txt文件：

File[] txtFiles = folder.listFiles(new FilenameFilter() {
    @Override
    public boolean accept(File dir, String name) {
        return name.endsWith(".txt"); // 筛选txt文件
    }
});

使用java.nio.file包（NIO）读取文件夹

Java 7引入的java.nio.file包提供了更现代、更灵活的文件操作方式，推荐在开发中优先使用，核心类包括Path、Paths和Files。

创建Path对象

Paths类的get()方法用于创建Path对象，替代File类的路径表示：

Path folderPath = Paths.get("D:/example");
Path folderPath = Paths.get("src/main/resources");

检查路径有效性

通过Files类的静态方法检查路径是否为目录：

if (!Files.exists(folderPath)) {
    System.out.println("文件夹不存在");
} else if (!Files.isDirectory(folderPath)) {
    System.out.println("路径不是文件夹");
}

遍历目录内容

Files类提供了newDirectoryStream()方法，返回一个DirectoryStream对象，用于遍历目录内容：

try (DirectoryStream<Path> stream = Files.newDirectoryStream(folderPath)) {
    for (Path path : stream) {
        if (Files.isRegularFile(path)) {
            System.out.println("文件: " + path.getFileName());
        } else if (Files.isDirectory(path)) {
            System.out.println("子目录: " + path.getFileName());
        }
    }
} catch (IOException e) {
    e.printStackTrace();
}

注意：DirectoryStream实现了AutoCloseable接口，建议使用try-with-resources语句确保资源自动关闭，避免内存泄漏。

递归遍历目录（NIO方式）

NIO提供了Files.walk()方法，支持递归遍历目录，并返回Stream<Path>，便于使用Stream API进行操作：

try (Stream<Path> stream = Files.walk(folderPath)) {
    stream.filter(Files::isRegularFile) // 仅保留文件
          .forEach(path -> System.out.println("文件路径: " + path));
} catch (IOException e) {
    e.printStackTrace();
}

Files.walk()默认会遍历所有层级的子目录，可通过maxDepth参数限制递归深度，例如Files.walk(folderPath, 1)仅遍历一级子目录。

使用文件属性过滤

结合Files.probeContentType()或BasicFileAttributes可以按文件类型、大小、修改时间等属性进行过滤，仅获取最近修改的文件：

try (Stream<Path> stream = Files.walk(folderPath)) {
    stream.filter(Files::isRegularFile)
          .max(Comparator.comparingLong(path -> {
              try {
                  return Files.getLastModifiedTime(path).toMillis();
              } catch (IOException e) {
                  return 0;
              }
          }))
          .ifPresent(path -> System.out.println("最近修改的文件: " + path));
} catch (IOException e) {
    e.printStackTrace();
}

异常处理与最佳实践

常见异常处理

• NullPointerException：路径参数为null，需检查输入有效性。
• SecurityException：程序无权限访问文件或目录，需确保运行环境有足够权限。
• IOException：文件操作失败（如路径不存在、磁盘损坏等），需捕获并处理异常。

最佳实践

• 优先使用NIO：java.nio.file功能更强大，支持符号链接、文件属性等高级特性，且性能优于传统IO。
• 资源管理：使用try-with-resources确保流、目录流等资源自动关闭。
• 路径兼容性：避免硬编码路径分隔符（如或\），使用Paths.get()或File.separator。
• 性能优化：若需处理大量文件，避免频繁IO操作，可考虑并行流（Files.walk().parallel()）提升效率。

Java读取文件夹可通过java.io.File或java.nio.file包实现。File类适合简单场景，代码直观；NIO包则提供了更高效、灵活的API，支持现代文件操作需求，实际开发中，应根据项目复杂度和性能要求选择合适的方式，并注重异常处理和资源管理,确保代码的健壮性和可维护性。