在Java中如何使用Files.walk遍历文件目录

P粉602998670 2025-10-26 00:00:00 次阅读

Files.walk可遍历目录树，返回Stream，支持限制深度、过滤文件类型及处理访问异常，需用try-with-resources确保资源释放。

在Java中，Files.walk 是 Java NIO.2 提供的一个非常方便的方法，用于遍历目录树。它返回一个 Stream，可以按深度优先的方式遍历指定目录下的所有文件和子目录。

基本用法

使用 Files.walk 遍历目录的基本步骤如下：

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

public class DirectoryWalker {
    public static void main(String[] args) {
        Path startDir = Paths.get("your/directory/path");

        try (Stream walk = Files.walk(startDir)) {
            walk.forEach(System.out::println);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

这段代码会打印出起始目录下所有文件和子目录的路径，包括嵌套多层的文件。

限制遍历深度

如果你只想遍历特定层级（比如只看当前目录和第一层子目录），可以传入第二个参数指定最大深度：

try (Stream walk = Files.walk(startDir, 2)) { // 最大深度为2
    walk.forEach(System.out::println);
} catch (IOException e) {
    e.printStackTrace();
}

例如，深度设为2时，只会进入一层子目录，不会继续深入。

筛选特定文件类型

结合 Stream 的 filter 方法，可以只处理特定类型的文件，比如只列出 .txt 文件：

try (Stream walk = Files.walk(startDir)) {
    walk.filter(Files::isRegularFile)         // 只保留普通文件
        .filter(path -> path.toString().endsWith(".txt"))
        .forEach(System.out::println);
} catch (IOException e) {
    e.printStackTrace();
}

这样可以避免处理目录，并只关注目标文件类型。

处理异常情况

遍历过程中可能遇到权限不足或文件被删除等问题。可以通过 walk() 的重载方法捕获并处理访问异常：

try (Stream walk = Files.walk(startDir, Integer.MAX_VALUE, FileVisitOption.FOLLOW_LINKS)) {
    walk.forEach(path -> {
        try {
            if (Files.isReadable(path)) {
                System.out.println("读取: " + path);
            }
        } catch (Exception e) {
            System.err.println("无法访问: " + path);
        }
    });
} catch (IOException e) {
    System.err.println("遍历失败: " + e.getMessage());
}