Java中高效复制目录树应使用Files.walkFileTree()配合SimpleFileVisitor，它轻量、支持符号链接与权限继承；通过preVisitDirectory创建目录、visitFile复制文件、visitFileFailed容错，并可跳过target等冗余目录。
Java 中高效复制目录树，关键在于避免手动递归、减少 I/O 阻塞，并利用 NIO.2 提供的原子性与异常鲁棒能力。推荐直接使用 Files.walkFileTree() 配合自定义 SimpleFileVisitor，它比 FileUtils.copyDirectory()（Apache Commons）更轻量、无额外依赖，且天然支持符号链接处理、权限继承和失败恢复。
用 walkFileTree 实现零拷贝式目录复制
核心思路是：遍历源目录时，对每个文件/目录同步创建目标路径并复制内容；对目录先创建，对文件再调用 Files.copy()。整个过程不加载文件到内存，流式传输，适合大目录。
- 目标路径需基于源路径动态计算：
target.resolve(source.relativize(file)) - 在
preVisitDirectory中创建目标子目录（含必要权限） - 在
visitFile中执行实际复制，可加REPLACE_EXISTING | COPY_ATTRIBUTES标志保留时间戳和权限 - 在
visitFileFailed中选择性跳过（如权限不足）而不中断整体流程
跳过冗余目录提升效率
开发项目常含 target、node_modules、.git 等无需复制的目录。可在 preVisitDirectory 中判断目录名，返回 FileVisitResult.SKIP_SUBTREE 直接跳过整棵子树，避免无谓遍历和 I/O。
- 示例：若
file.getFileName().toString().matches("(?i)target|node_modules|\.git")，则返回SKIP_SUBTREE - 该策略比事后过滤文件更早终止，节省 CPU 和系统调用开销
处理特殊文件类型与异常边界
真实场景中需应对符号链接、只读文件、跨文件系统等情形：
立即学习“Java免费学习笔记（深入）”；
- 默认
walkFileTree不跟随符号链接；如需跟随，传入EnumSet.of(FileVisitOption.FOLLOW_LINKS) - 复制只读文件时，先用
Files.setAttribute(..., "dos:readonly", false)（Windows）或setPosixFilePermissions（Linux/macOS）临时放开权限 - 跨文件系统复制失败时，
visitFileFailed会抛出IOException，建议记录日志并返回CONTINUE保证其余文件继续复制
完整可运行示例（带错误日志与跳过逻辑）
以下代码将 /src 完整复制到 /backup/src，自动跳过构建目录，保留属性，并记录失败项：
（注意：目标父目录需预先存在，或在复制前用 Files.createDirectories() 创建）
