Files.walkFileTree 是 Java NIO 中最推荐的文件树遍历方式，基于访问者模式，无需手动递归，支持细粒度控制、符号链接处理及异常恢复；通过继承 SimpleFileVisitor<Path> 重写 visitFile 等方法即可定制行为。
用 Files.walkFileTree 遍历文件树是 Java NIO 中最推荐、最灵活的方式，它基于访问者模式（Visitor Pattern），避免手动递归、不爆栈、支持细粒度控制，还能天然处理符号链接、权限异常等边界情况。
核心：用 SimpleFileVisitor 定制行为
不需要自己写递归逻辑，只需继承 SimpleFileVisitor<Path>，重写你需要响应的方法即可。常用方法有：
- preVisitDirectory：进入目录前触发（可返回 SKIP_SUBTREE 跳过该子树）
- visitFile：访问普通文件时触发（最常用）
- visitFileFailed：访问失败时触发（如无权限、路径不存在），可选择继续遍历
- postVisitDirectory：离开目录后触发（可用于清理或统计）
基础示例：打印所有 .java 文件路径
以下代码安全遍历当前项目 src 目录，只处理 .java 文件，跳过访问失败的条目：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
Path start = Paths.get("src");
Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
if (file.toString().endsWith(".java")) {
System.out.println(file);
}
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult visitFileFailed(Path file, IOException exc) {
// 忽略权限不足等异常，继续遍历
return FileVisitResult.CONTINUE;
}
});
进阶技巧：限制深度 + 过滤 + 提前终止
通过传递 FileVisitor 的同时配合 Integer.MAX_VALUE 或具体数值控制最大深度；用 Files.isRegularFile / Files.isDirectory 做类型判断；必要时直接返回 TERMINATE 终止整个遍历：
立即学习“Java免费学习笔记（深入）”；
- 限制最多遍历 3 层：
Files.walkFileTree(start, EnumSet.noneOf(FileVisitOption.class), 3, visitor) - 跳过隐藏目录（如 .git）：在
preVisitDirectory中检查目录名，匹配则返回SKIP_SUBTREE - 找到第一个匹配文件就退出：在
visitFile中返回FileVisitResult.TERMINATE
替代方案对比：为什么不用 Files.walk 或 Files.list
Files.walk() 返回 Stream，写法更函数式，但会一次性加载全部路径（内存敏感场景慎用）；Files.list() 只遍历单层，不递归。而 walkFileTree 是真正按需访问、可控性强、异常可恢复的“生产级”方案——尤其适合扫描大项目、日志归档、资源打包等场景。
