Files.walkFileTree()可安全高效遍历目录树，基于NIO.2 FileVisitor接口，自动处理符号链接、权限异常等；需传入起始Path和SimpleFileVisitor实现，重写preVisitDirectory、visitFile、visitFileFailed、postVisitDirectory四方法控制流程。

使用 Files.walkFileTree() 可以安全、高效地递归遍历整个目录树，它基于 NIO.2 的 FileVisitor 接口，能自动处理符号链接、权限异常、循环引用等边界情况，比手动递归更健壮。

核心用法：传入起始路径和自定义 FileVisitor

你需要实现 SimpleFileVisitor（推荐）或完整实现 FileVisitor 接口。最常用的是重写以下四个方法：

• preVisitDirectory：进入目录前调用（可用于过滤跳过某些目录）
• visitFile：访问普通文件时调用（核心逻辑放这里，比如打印路径、读取内容、匹配文件名）
• visitFileFailed：访问文件失败时调用（如无权限、文件被占用，可选择继续遍历）
• postVisitDirectory：离开目录后调用（可用于统计、清理资源）

一个实用示例：列出所有 .java 文件的绝对路径

下面代码会遍历指定根目录，只打印后缀为 .java 的文件路径：

Path start = Paths.get("/your/project/src");
Files.walkFileTree(start, new SimpleFileVisitor<path>() {
    @Override
    public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) {
        if (file.toString().endsWith(".java")) {
            System.out.println(file.toAbsolutePath());
        }
        return FileVisitResult.CONTINUE;
    }

    @Override
    public FileVisitResult visitFileFailed(Path file, IOException exc) {
        // 忽略无法访问的文件（如权限不足），继续遍历
        return FileVisitResult.CONTINUE;
    }
});</path>

进阶技巧：控制遍历行为

你可以通过返回值精细控制流程：

• 返回 CONTINUE：继续遍历下一个条目
• 返回 SKIP_SIBLINGS：跳过当前目录下其余同级项（但不退出当前目录）
• 返回 SKIP_SUBTREE：跳过当前目录的所有子目录（即不进入该目录）
• 返回 TERMINATE：立即终止整个遍历

例如，在 preVisitDirectory 中判断目录名为 "target" 或 "node_modules"，直接返回 SKIP_SUBTREE 就能跳过构建产物目录，提升效率。

注意点与常见问题

使用时需留意几个关键细节：

• 路径对象是 Path 类型，不是 String；建议用 Paths.get(...) 创建
• 默认不跟随符号链接；如需跟随，要显式传入 FileVisitOption.FOLLOW_LINKS
• 遇到 I/O 异常（如磁盘断开）会抛出 IOException，应在外层 try-catch
• 遍历过程是单线程同步执行，如需并发处理，请配合线程池 + visitFile 中提交任务