在Java中，Files.walk是java.nio.file.Files类提供的用于遍历文件目录的静态方法，它基于Stream API实现，能够递归遍历指定路径下的所有文件和子目录，相比传统的递归遍历方式，代码更简洁，逻辑更清晰。该方法有多个重载版本，开发者可以根据需求选择合适的参数配置，实现不同场景下的目录遍历需求。
Files.walk的基础用法
Files.walk的最基础重载版本只需要传入一个起始路径参数，默认会遍历到目录的最深层，返回的是一个Stream<Path>对象，每个Path元素代表遍历到的文件或目录路径。需要注意的是，该Stream属于IO资源，使用完成后必须手动关闭，否则可能会造成资源泄漏。
下面是一个最基础的遍历示例，打印指定目录下的所有文件和子目录路径：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;
public class FilesWalkDemo {
public static void main(String[] args) {
// 定义要遍历的起始目录路径
Path startPath = Paths.get("D:/testDir");
// 使用try-with-resources自动关闭Stream资源
try (Stream<Path> pathStream = Files.walk(startPath)) {
// 遍历所有路径并打印
pathStream.forEach(path -> System.out.println(path));
} catch (IOException e) {
e.printStackTrace();
}
}
}
控制遍历深度
默认的Files.walk会遍历到目录的最深层，实际开发中我们往往不需要遍历太深的层级，这时候可以使用带maxDepth参数的重载方法，maxDepth表示最大遍历深度，值为0时只遍历起始路径本身，值为1时遍历起始路径和它的直接子文件/子目录，以此类推。
下面的示例限制遍历深度为2层，只打印起始目录和直接子目录下的内容：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;
public class FilesWalkDepthDemo {
public static void main(String[] args) {
Path startPath = Paths.get("D:/testDir");
// maxDepth设为2，最多遍历两层目录
try (Stream<Path> pathStream = Files.walk(startPath, 2)) {
pathStream.forEach(path -> System.out.println("遍历到路径：" + path));
} catch (IOException e) {
e.printStackTrace();
}
}
}
过滤指定类型的文件
遍历目录时经常需要筛选出特定类型的文件，比如只获取所有的.txt文件，这时候可以结合Stream的filter方法实现过滤。Files类提供了isRegularFile、isDirectory等静态方法，可以用来判断路径对应的是普通文件还是目录，也可以结合Path的endsWith方法判断文件后缀。
下面的示例遍历目录并筛选出所有的.txt文件：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;
public class FilesWalkFilterDemo {
public static void main(String[] args) {
Path startPath = Paths.get("D:/testDir");
try (Stream<Path> pathStream = Files.walk(startPath)) {
pathStream
// 过滤出普通文件
.filter(Files::isRegularFile)
// 过滤出后缀为.txt的文件
.filter(path -> path.toString().endsWith(".txt"))
.forEach(txtFile -> System.out.println("找到txt文件：" + txtFile));
} catch (IOException e) {
e.printStackTrace();
}
}
}
遍历过程中的文件操作
除了遍历打印路径，我们还可以在遍历过程中对文件进行实际操作，比如批量复制、移动、删除文件等。下面的示例遍历目录下的所有.jpg文件，将它们复制到另一个目标目录中：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.util.stream.Stream;
public class FilesWalkOperateDemo {
public static void main(String[] args) {
Path sourceDir = Paths.get("D:/sourceDir");
Path targetDir = Paths.get("D:/targetDir");
// 先确保目标目录存在，不存在则创建
try {
if (!Files.exists(targetDir)) {
Files.createDirectories(targetDir);
}
try (Stream<Path> pathStream = Files.walk(sourceDir)) {
pathStream
.filter(Files::isRegularFile)
.filter(path -> path.toString().endsWith(".jpg"))
.forEach(jpgFile -> {
// 构建目标路径，保持原文件名
Path targetPath = targetDir.resolve(jpgFile.getFileName());
try {
Files.copy(jpgFile, targetPath, StandardCopyOption.REPLACE_EXISTING);
System.out.println("复制文件成功：" + jpgFile);
} catch (IOException e) {
System.out.println("复制文件失败：" + jpgFile + "，错误原因：" + e.getMessage());
}
});
}
} catch (IOException e) {
e.printStackTrace();
}
}
}
注意事项
- Files.walk返回的Stream必须关闭，推荐使用try-with-resources语法自动关闭，避免资源泄漏。
- 遍历过程中如果遇到没有权限访问的目录，会抛出AccessDeniedException，需要提前做好异常处理。
- maxDepth参数如果设置过大，遍历深层目录时可能会消耗较多内存和时间，需要根据实际需求合理设置。
- 如果不需要遍历子目录，只想获取当前目录的直接内容，可以使用Files.list方法，它只会遍历一层目录，性能更好。
常见问题解答
遍历时如何跳过某些目录？
可以在filter中判断路径是否为需要跳过的目录，如果是则过滤掉。比如要跳过名为temp的目录，可以添加过滤条件：filter(path -> !Files.isDirectory(path) || !path.getFileName().toString().equals("temp"))。
遍历大目录时会不会内存溢出？
Files.walk返回的是延迟加载的Stream，不会一次性把所有路径加载到内存中，正常遍历大目录不会出现内存溢出问题，但是如果使用collect方法把所有路径收集到集合中，且目录内容非常多，就可能导致内存溢出，建议直接通过forEach处理，不要收集到集合。
Files_walkJava文件遍历目录操作修改时间：2026-07-11 05:12:35