java nio的files.walkfiletree是目录遍历首选，支持符号链接控制、异常细粒度处理、深度/广度优先及防栈溢出；安全删除需继承simplefilevisitor，在visitfile删文件、postvisitdirectory删空目录；智能拷贝可借previsitdirectory跳过子树、visitfile过滤文件，并用resolve确保路径兼容。

Java NIO 的 Paths 与 Files.walkFileTree 是处理目录遍历类操作的推荐方式，尤其适合需要精细控制（如跳过特定文件、按条件过滤、并发安全删除或带进度拷贝）的场景。相比 File.delete() 或递归 listFiles()，它天然支持符号链接处理、访问权限异常捕获、深度优先/广度优先遍历，并能避免栈溢出。

用 Files.walkFileTree 安全删除整个目录

直接调用 Files.delete(path) 只能删空目录或单个文件，非空目录会抛 DirectoryNotEmptyException。正确做法是先遍历子项，从底向上删除：

• 继承 SimpleFileVisitor<path></path>，重写 visitFile 删除文件，postVisitDirectory 删除空目录
• 注意：必须在 postVisitDirectory 中删目录（而非 visitDirectory），否则子项还没处理完就删父目录会失败
• 对 IOException 做细粒度处理：比如跳过权限不足的文件，但继续处理其余项

示例代码：

Path root = Paths.get("/tmp/to-delete");
Files.walkFileTree(root, new SimpleFileVisitor<path>() {
    @Override
    public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
        try {
            Files.delete(file);
        } catch (AccessDeniedException e) {
            System.err.println("拒绝访问: " + file);
            return FileVisitResult.CONTINUE;
        }
        return FileVisitResult.CONTINUE;
    }

    @Override
    public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
        if (exc == null) {
            Files.delete(dir);
        } else {
            System.err.println("无法进入目录: " + dir + ", 错误: " + exc);
        }
        return FileVisitResult.CONTINUE;
    }
});
</path>

实现带过滤与跳过的智能目录拷贝

拷贝不是简单复制所有内容，常需排除 .git、target、临时文件等。利用 visitFile 和 preVisitDirectory 配合路径判断即可实现：

Alibabacloud Sdk Client Initialization For Java

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

下载

• 在 preVisitDirectory 中检查当前目录是否应跳过（如匹配 **/node_modules），返回 SKIP_SUBTREE 即可跳过整个子树
• 在 visitFile 中决定是否拷贝该文件（例如只拷贝 .java 或 .xml）
• 拷贝时用 Files.createDirectories 确保目标父目录存在，再用 Files.copy 并指定 REPLACE_EXISTING 和 COPY_ATTRIBUTES

关键点：源路径转目标路径要用 resolve 而非字符串拼接，确保跨平台兼容性：

Path srcRoot = Paths.get("src");
Path dstRoot = Paths.get("backup");
Files.walkFileTree(srcRoot, new SimpleFileVisitor<path>() {
    @Override
    public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
        String name = dir.getFileName().toString();
        if ("node_modules".equals(name) || ".git".equals(name)) {
            return FileVisitResult.SKIP_SUBTREE;
        }
        Path targetDir = dstRoot.resolve(srcRoot.relativize(dir));
        Files.createDirectories(targetDir);
        return FileVisitResult.CONTINUE;
    }

    @Override
    public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
        if (file.toString().endsWith(".log")) return FileVisitResult.CONTINUE;
        Path targetFile = dstRoot.resolve(srcRoot.relativize(file));
        Files.copy(file, targetFile, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.COPY_ATTRIBUTES);
        return FileVisitResult.CONTINUE;
    }
});
</path>

处理符号链接与异常的健壮性技巧

默认情况下 walkFileTree 会跟随符号链接（可能造成循环或越界）。若需安全处理：

• 构造 FileTreeIterator 时传入 EnumSet.of(FileVisitOption.FOLLOW_LINKS) 显式开启；不传则默认不跟随
• 在 visitFileFailed 中统一捕获无法访问的条目（如损坏的软链、无权限目录），避免中断整个遍历
• 若需记录错误或统计失败数，可在 visitor 中定义成员变量并同步更新（注意多线程下需加锁或用 AtomicInteger）

替代方案提醒：Files.walk 与 Files.list 的适用边界

Files.walk 返回 Stream<path></path> 更函数式，适合简单过滤+并行处理（如统计总大小），但它不提供访问顺序控制和目录进入/退出钩子；Files.list 仅列出一级内容，不递归。真正需要“边遍历边决策”（如动态跳过、提前终止、父子联动操作）时，walkFileTree 仍是不可替代的核心 API。

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