Java 实例 – 遍历指定目录下的所有文件（完整教程）

Java 实例 – 遍历指定目录下的所有文件

在日常开发中，我们经常需要处理文件系统，比如备份数据、清理日志、批量重命名文件等。而“遍历指定目录下的所有文件”正是这类操作的基础。无论你是初学者还是有一定经验的开发者，掌握这个 Java 实例都非常实用。

想象一下，你的项目根目录下有上百个 .java 文件，现在要统一检查编码格式或替换某个类名。手动一个一个打开显然不现实，这时就需要程序自动帮你“扫描”整个目录，把所有文件找出来。这就是我们今天要解决的问题：如何用 Java 遍历指定目录下的所有文件。

Java 提供了强大的 java.nio.file 包来处理文件系统，其中 Files 和 Paths 类是核心工具。我们接下来就一步步来实现这个功能。

使用 Files.walk() 方法实现递归遍历

Java 8 引入了新的 NIO.2 API，提供了更简洁、高效的文件操作方式。其中 Files.walk() 是最推荐的方法，它能递归遍历目录及其子目录中的所有文件。

下面是一个完整的示例代码：

import java.io.IOException;
import java.nio.file.*;
import java.util.stream.Stream;

public class FileWalkerExample {

    public static void main(String[] args) {
        // 指定要遍历的目录路径
        String directoryPath = "/Users/yourname/Documents/MyProject";

        // 使用 Paths.get() 创建路径对象
        Path startPath = Paths.get(directoryPath);

        // 检查路径是否存在且为目录
        if (!Files.exists(startPath)) {
            System.err.println("指定的目录不存在：" + directoryPath);
            return;
        }

        if (!Files.isDirectory(startPath)) {
            System.err.println("指定的路径不是一个目录：" + directoryPath);
            return;
        }

        // 使用 Files.walk() 遍历所有文件和子目录
        try (Stream<Path> stream = Files.walk(startPath)) {
            // 过滤出文件（排除目录）
            stream.filter(Files::isRegularFile)
                  .forEach(path -> System.out.println("找到文件：" + path.toString()));
        } catch (IOException e) {
            System.err.println("遍历过程中发生错误：" + e.getMessage());
        }
    }
}

代码解析

• Paths.get(directoryPath)：将字符串路径转换为 Path 对象，这是 NIO.2 的标准做法。
• Files.exists(startPath)：检查路径是否存在，避免程序崩溃。
• Files.isDirectory(startPath)：确认路径是一个目录，防止传入文件路径导致异常。
• Files.walk(startPath)：返回一个 Stream<Path>，包含起始路径及其所有子目录和文件。
• .filter(Files::isRegularFile)：只保留普通文件，跳过目录。
• forEach(path -> ...)：对每个文件路径执行打印操作。
• try-with-resources：确保资源正确关闭，避免内存泄漏。

这个方法的优势在于代码简洁、功能强大，能自动处理嵌套目录。

通过递归函数手动实现遍历

如果你对底层机制感兴趣，或者想自定义遍历逻辑，也可以使用递归函数来实现。这种方式更灵活，适合需要添加额外判断条件的场景。

import java.io.File;

public class RecursiveFileTraverse {

    public static void main(String[] args) {
        // 指定目录路径
        String directoryPath = "/Users/yourname/Desktop/TestFolder";

        // 创建 File 对象
        File directory = new File(directoryPath);

        // 检查目录是否存在
        if (!directory.exists() || !directory.isDirectory()) {
            System.err.println("目录不存在或不是有效目录：" + directoryPath);
            return;
        }

        // 调用递归方法开始遍历
        traverseDirectory(directory);
    }

    // 递归遍历目录及其子目录
    public static void traverseDirectory(File dir) {
        // 获取目录下的所有文件和子目录
        File[] files = dir.listFiles();

        // 如果目录为空，直接返回
        if (files == null) {
            return;
        }

        // 遍历每个文件/目录
        for (File file : files) {
            if (file.isFile()) {
                // 如果是文件，打印路径
                System.out.println("文件：" + file.getAbsolutePath());
            } else if (file.isDirectory()) {
                // 如果是目录，递归调用自己
                System.out.println("目录：" + file.getAbsolutePath());
                traverseDirectory(file); // 递归进入子目录
            }
        }
    }
}

关键点说明

• File[] files = dir.listFiles()：获取目录下的所有条目，返回数组。
• file.isFile()：判断是否为文件。
• file.isDirectory()：判断是否为目录。
• 递归调用 traverseDirectory(file)：进入子目录继续遍历。

这个方法虽然代码量稍多，但逻辑清晰，便于理解和调试。特别适合初学者学习递归思想。

按文件类型筛选遍历结果

很多时候我们不需要遍历所有文件，而是只关心某类文件，比如 .txt、.jpg 或 .java 文件。我们可以通过 Path.getFileName() 和 String.endsWith() 来实现筛选。

import java.io.IOException;
import java.nio.file.*;
import java.util.stream.Stream;

public class FilteredFileTraverse {

    public static void main(String[] args) {
        String directoryPath = "/Users/yourname/Code/Projects";

        Path startPath = Paths.get(directoryPath);

        if (!Files.exists(startPath) || !Files.isDirectory(startPath)) {
            System.err.println("无效的目录路径：" + directoryPath);
            return;
        }

        // 定义要查找的文件扩展名（小写）
        String targetExtension = ".java";

        try (Stream<Path> stream = Files.walk(startPath)) {
            // 只保留文件，并且扩展名匹配
            stream.filter(Files::isRegularFile)
                  .filter(path -> path.getFileName().toString().toLowerCase()
                                        .endsWith(targetExtension.toLowerCase()))
                  .forEach(path -> System.out.println("Java 文件：" + path.toString()));
        } catch (IOException e) {
            System.err.println("遍历失败：" + e.getMessage());
        }
    }
}

使用技巧

• path.getFileName()：获取文件名（不含路径）。
• toString().toLowerCase()：统一转为小写，避免大小写问题。
• endsWith()：判断文件扩展名是否匹配。

这个技巧在实际项目中非常实用，比如你可以批量处理所有 .log 文件进行压缩，或查找所有 .xml 配置文件进行校验。

遍历结果的路径处理与格式化输出

有时候我们不仅需要知道文件路径，还希望对路径进行格式化，比如提取目录层级、计算文件数量等。下面是一个带统计功能的版本：

import java.io.IOException;
import java.nio.file.*;
import java.util.HashSet;
import java.util.Set;

public class FileTraverseWithStats {

    public static void main(String[] args) {
        String directoryPath = "/Users/yourname/Downloads";

        Path startPath = Paths.get(directoryPath);

        if (!Files.exists(startPath) || !Files.isDirectory(startPath)) {
            System.err.println("目录无效：" + directoryPath);
            return;
        }

        // 用于存储文件路径
        Set<String> fileSet = new HashSet<>();
        int fileCount = 0;
        int dirCount = 0;

        try (Stream<Path> stream = Files.walk(startPath)) {
            stream.forEach(path -> {
                if (Files.isRegularFile(path)) {
                    fileSet.add(path.toString());
                    fileCount++;
                } else if (Files.isDirectory(path)) {
                    dirCount++;
                }
            });
        } catch (IOException e) {
            System.err.println("遍历失败：" + e.getMessage());
            return;
        }

        // 输出统计结果
        System.out.println("总共找到 " + fileCount + " 个文件");
        System.out.println("总共找到 " + dirCount + " 个目录");
        System.out.println("所有文件路径：");
        fileSet.forEach(System.out::println);
    }
}

实用价值

• 使用 Set<String> 避免重复路径（虽然一般不会重复，但用于去重更安全）。
• 统计文件和目录数量，便于后续分析。
• 输出清晰，适合日志记录或报告生成。

常见问题与注意事项

在实际使用中，可能会遇到以下问题，这里一并提醒：

建议在生产环境中加入异常捕获和日志记录，提升程序健壮性。

总结

通过本文，我们系统地学习了 Java 实例 – 遍历指定目录下的所有文件 的多种实现方式。从 Files.walk() 的简洁写法，到递归函数的底层逻辑，再到按类型筛选和统计功能，每一种方法都有其适用场景。

• 对于简单需求，推荐使用 Files.walk()，代码短、效率高。
• 对于学习递归思想，递归函数更直观。
• 对于特定文件类型处理，结合 endsWith() 可实现精准筛选。
• 对于复杂场景，建议加入异常处理与统计功能。

掌握这一技能，不仅能提升开发效率，还能为后续的文件批量处理、日志分析、项目构建等任务打下坚实基础。希望你能动手实践，把代码跑起来，真正理解“遍历”的含义——就像在图书馆里一本本翻阅书架，把所有书找出来一样。