files.walk() 是 java 中遍历多级目录树最简洁高效的方式，基于 nio.2 返回惰性 stream，支持深度控制、异常处理、过滤、并行等操作。
Java 中 Files.walk() 是遍历多级目录树最简洁高效的方式之一，它基于 NIO.2，返回一个惰性加载的 Stream<path></path>，天然支持递归、过滤、并行处理等操作。
理解 walk 的基本用法
Files.walk() 默认从指定根路径开始，深度优先遍历所有子目录和文件（包括根本身）。它会自动跳过无法访问的路径（如权限不足），并抛出 IOException（需显式捕获或声明）。
- 单参数形式：
Files.walk(path)—— 遍历无限层级（实际受系统栈或路径深度限制） - 双参数形式：
Files.walk(path, maxDepth)—— 控制最大遍历深度，例如Files.walk(dir, 3)只查根 + 两层子目录
安全遍历：处理异常与权限问题
遇到符号链接循环、拒绝访问目录时，walk() 默认中断。若想跳过异常继续遍历，需用 Files.walk(path, FileVisitOption.FOLLOW_LINKS) 并配合 try-catch 在流中处理：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 推荐方式：用
Files.walk(path).onClose(() -> { /* 清理资源 */ }).forEach(...)确保流关闭 - 更稳妥做法：将
walk()包在 try-with-resources 中：try (Stream<path> stream = Files.walk(Paths.get("src")))</path>
这样即使中途异常，流也会自动关闭 - 跳过访问失败项：可先用
Files.isReadable(path)过滤，或在forEach内捕获AccessDeniedException
常用过滤与转换操作
借助 Stream API，可以链式完成常见需求：
- 只取普通文件：
.filter(Files::isRegularFile) - 按扩展名筛选：
.filter(p -> p.toString().endsWith(".java")) - 获取相对路径（相对于根目录）：
.map(root::relativize) - 统计文件数：
.count()；收集为列表：.collect(Collectors.toList()) - 并行处理（适合大量文件且操作耗时）：
Files.walk(path).parallel().forEach(...)，注意线程安全
替代方案对比：walk vs walkFileTree
Files.walk() 适合函数式、声明式写法，代码短小清晰；而 Files.walkFileTree() 基于回调（FileVisitor），更适合需要精细控制访问顺序、提前终止、或需分别处理 preVisitDirectory/visitFile/postVisitDirectory 的场景。比如要跳过某个目录，walkFileTree 可返回 SKIP_SUBTREE，而 walk() 只能靠过滤或中断流。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
