files.walk 是 java nio.2 提供的递归遍历文件树方法，返回 stream，需 try-with-resources 管理资源；支持限制深度、filter 过滤、异常需手动处理。
Files.walk 是 Java NIO.2 提供的便捷方法，用于递归遍历整个文件树（目录及其所有子目录、文件），返回一个 Stream<path></path>，天然支持函数式操作，比手动递归或 FileVisitor 更简洁。
基本用法：遍历并打印所有路径
最简单的使用方式是调用 Files.walk() 并消费流：
try (Stream<path> stream = Files.walk(Paths.get("/home/user/docs"))) {
stream.forEach(System.out::println);
}</path>
注意必须用 try-with-resources，因为该流内部持有打开的目录资源，不显式关闭可能导致句柄泄漏（尤其在 Windows 上）。
限制深度：避免遍历过深或过大目录
可传入第二个参数指定最大访问深度（从起始路径算起，根为 0 层）：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
Files.walk(path, 2)：只遍历起始目录及其直接子目录内的内容（共 3 层） - 深度为 1 时，只包含起始目录自身和它的直接子项（不递归子目录）
这对防止意外扫描整个磁盘或跳过深层临时目录很实用。
过滤与处理：跳过特定文件或提前终止
利用 Stream 的中间操作可灵活控制遍历行为：
-
跳过某些路径：用
filter排除 .git、target、__pycache__ 等目录或 .tmp 文件 -
只处理文件：加
.filter(Files::isRegularFile) -
提前终止：用
limit(n)或结合anyMatch实现条件中断（但注意：findAny/findFirst会自动短路，无需遍历全部）
示例：列出所有 .java 文件（不包括目录）
try (Stream<path> stream = Files.walk(Paths.get("src"))) {
stream
.filter(Files::isRegularFile)
.filter(p -> p.toString().endsWith(".java"))
.forEach(System.out::println);
}</path>
异常处理：跳过无法访问的目录
Files.walk 默认遇到权限不足或路径不存在等 I/O 异常会直接抛出 IOException。如需容错继续遍历，应改用 Files.walkFileTree 配合自定义 FileVisitor；或者先用 Files.isReadable 做前置检查（但存在竞态风险）。简单场景下，也可捕获异常并记录日志后退出 —— 因为 walk 本身不提供内置的“跳过并继续”机制。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
