java nio推荐用files.walk()遍历目录树，它比递归更简洁、支持流式处理、可设深度和异常策略；默认包含起始路径及所有后代，需try-with-resources关闭，可用maxdepth限制层级，配合stream api过滤转换。

Java NIO 中推荐用 Files.walk() 配合 Path 遍历目录树，它比传统递归更简洁、支持流式处理、可控制深度和异常策略。

用 Files.walk() 简单遍历所有子路径

最常用方式是调用 Files.walk(Path) 获取一个 Stream<path></path>，自动深度优先遍历整个子树：

• 返回的流包含起始路径自身 + 所有后代文件/目录（按访问顺序）
• 需手动关闭流（建议 try-with-resources），尤其在大目录或有 I/O 异常时
• 默认不限制深度，适合中小规模目录

try (Stream<path> paths = Files.walk(Paths.get("/home/user/docs"))) {
    paths.filter(Files::isRegularFile)
         .forEach(System.out::println);
}</path>

限制遍历深度避免过深或失控

用重载方法 Files.walk(Path, int maxDepth) 可设最大层级（从起始目录算起，0 表示只查自身，1 表示自身 + 直接子项）：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• Files.walk(dir, 2)：遍历 dir、它的直接子目录、以及这些子目录下的文件和子目录（但不再往下）
• 深度值为 0 时，流中只有起始路径本身
• 对深层嵌套或不确定结构的目录，加深度限制能防栈溢出或性能骤降

优雅处理访问异常（如权限不足）

默认情况下，遇到无法访问的子目录（如 PermissionDeniedException），Files.walk() 会中断并抛异常。可通过 FileVisitOption.FOLLOW_LINKS 和自定义错误策略规避：

• 传入 EnumSet.of(FileVisitOption.FOLLOW_LINKS) 可跟随符号链接（注意循环引用）
• 更稳妥的是改用 Files.walkFileTree() + 自定义 SimpleFileVisitor，在 visitFileFailed() 中返回 FileVisitResult.CONTINUE 继续遍历
• 若坚持用 walk()，可用 onClose() 或 tryAdvance() 结合异常捕获，但不如 walkFileTree 精细

过滤与转换常见操作

利用 Stream API 可自然完成路径筛选、属性检查、内容读取等：

• filter(Files::isDirectory) 只保留目录
• filter(p -> p.toString().endsWith(".log")) 按扩展名过滤
• map(Path::getFileName).map(Object::toString) 提取文件名字符串
• peek(p -> System.out.println("Visiting: " + p)) 调试时打印路径
• 注意：Files.isXxx() 方法内部会触发 I/O，多次调用可能影响性能，可先用 Files.readAttributes() 一次性读取多个属性

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南