Java 实例 – 遍历指定目录下的所有目录（一文讲透）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Java 开发中，遍历指定目录下的所有目录是一个常见需求。无论是文件管理工具开发、日志分析系统，还是自动化脚本编写，开发者都需要掌握如何高效、准确地遍历目录结构。本文将从基础概念出发，结合代码示例和实际案例，系统讲解 Java 中遍历目录的多种方法。通过循序渐进的讲解，帮助读者理解目录遍历的核心逻辑，同时对比不同实现方式的优缺点，为实际开发提供参考。

一、基础概念：目录结构与 File 类

1.1 目录结构的树形比喻

计算机文件系统可以类比为一棵“文件树”，每个目录（Folder）是树的节点，而文件（File）是叶子节点。例如，根目录 / 是树的主干，子目录 Documents 是主干上的分支，而 Documents 下的 Report.txt 则是末端的叶子。遍历目录的过程，就是沿着这棵树的枝干，逐层展开并访问所有节点。

1.2 Java 的 File 类：目录操作的基石

Java 的 java.io.File 类是处理文件和目录的核心工具。它提供了一系列方法，例如：

• listFiles()：获取目录下的所有文件和子目录
• isDirectory()：判断路径是否为目录
• getName()：获取文件或目录的名称

示例代码：

File rootDir = new File("/path/to/directory");
File[] files = rootDir.listFiles();
if (files != null) {
    for (File file : files) {
        if (file.isDirectory()) {
            System.out.println("目录：" + file.getName());
        } else {
            System.out.println("文件：" + file.getName());
        }
    }
}

1.3 目录遍历的核心逻辑

遍历目录需要解决两个问题：

1. 递归终止条件：当遇到非目录时停止深入
2. 遍历顺序：深度优先（DFS）或广度优先（BFS）

二、传统方法：基于 File 类的迭代遍历

2.1 传统迭代法的实现步骤

传统方法通过循环和条件判断逐层访问子目录，无需递归函数。其核心步骤如下：

1. 初始化待处理的目录队列（可用 LinkedList<File> 实现）
2. 取出队列首元素，遍历其子项
3. 将子目录加入队列，重复步骤 2

代码示例：

public static void traverseDirectory(File dir) {
    Queue<File> queue = new LinkedList<>();
    queue.add(dir);
    
    while (!queue.isEmpty()) {
        File currentFile = queue.poll();
        if (currentFile.isDirectory()) {
            System.out.println("进入目录：" + currentFile.getAbsolutePath());
            File[] children = currentFile.listFiles();
            if (children != null) {
                for (File child : children) {
                    queue.add(child);
                }
            }
        }
    }
}

2.2 方法优缺点分析

三、递归方法：简洁的深度优先遍历

3.1 递归的核心思想

递归通过函数自身调用实现“分而治之”，非常适合目录树的遍历。其核心逻辑：

遍历当前目录 -> 遍历子目录 -> 递归调用自身

代码示例：

public static void recursiveTraverse(File dir) {
    if (dir.isDirectory()) {
        System.out.println("进入目录：" + dir.getAbsolutePath());
        File[] children = dir.listFiles();
        if (children != null) {
            for (File child : children) {
                recursiveTraverse(child); // 递归调用
            }
        }
    }
}

3.2 递归的潜在风险与解决方案

• 栈溢出风险：当目录层级过深时，递归可能导致 StackOverflowError
• 解决方案：
  1. 改用迭代方法（如前文的队列实现）
  2. 限制递归深度或分批次处理

四、Java NIO 新特性：Files.walk 的优雅实现

4.1 Java NIO 的 Files 类

Java 7 引入的 java.nio.file.Files 类提供了更简洁的遍历方式，核心方法：

• Files.walk()：返回一个 Stream<Path>，支持流式操作
• FileVisitor 接口：定义自定义访问逻辑

示例代码：

Path startPath = Paths.get("/path/to/directory");
try (Stream<Path> stream = Files.walk(startPath)) {
    stream.forEach(path -> {
        if (Files.isDirectory(path)) {
            System.out.println("目录：" + path);
        }
    });
} catch (IOException e) {
    e.printStackTrace();
}

4.2 NIO 方法的优势

五、实战案例：统计指定目录下的文件总数

5.1 需求分析

假设需要编写一个工具类，统计指定目录及其子目录中的所有文件数量（不含目录）。

5.2 实现方案对比

方案 1：递归法

public static int countFilesRecursively(File dir) {
    int count = 0;
    if (dir.isDirectory()) {
        File[] children = dir.listFiles();
        if (children != null) {
            for (File child : children) {
                if (child.isFile()) {
                    count++;
                } else {
                    count += countFilesRecursively(child); // 递归统计子目录
                }
            }
        }
    }
    return count;
}

方案 2：Files.walk 的流式统计

public static long countFilesWithNIO(Path path) throws IOException {
    return Files.walk(path)
        .filter(Files::isRegularFile) // 过滤出普通文件
        .count();
}

5.3 性能对比测试

六、进阶技巧：处理特殊场景

6.1 忽略隐藏文件

在 Linux 系统中，隐藏文件以 . 开头。可以通过 FilenameFilter 过滤：

File[] visibleFiles = dir.listFiles((dir, name) -> !name.startsWith("."));

6.2 处理权限异常

在访问某些目录时，可能因权限不足导致 AccessDeniedException。建议在遍历时捕获 SecurityException：

try {
    File[] children = dir.listFiles();
    // ...处理逻辑...
} catch (SecurityException e) {
    System.err.println("无权访问：" + dir.getAbsolutePath());
}

七、总结

本文通过对比传统迭代、递归和 Java NIO 的三种方法，系统讲解了目录遍历的核心实现逻辑。开发者需根据实际场景选择合适方案：

• 简单需求：优先使用 Files.walk() 实现简洁代码
• 复杂逻辑：递归或迭代法提供更灵活的控制
• 性能敏感场景：需结合测试数据选择最优方案

掌握目录遍历技术后，可以进一步扩展到文件搜索、批量重命名等实用工具的开发。希望本文能帮助读者在 Java 文件操作领域建立扎实的基础，并为后续的进阶学习提供参考。