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>，重写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;
}
});
实现带过滤与跳过的智能目录拷贝
拷贝不是简单复制所有内容，常需排除 .git、target、临时文件等。利用 visitFile 和 preVisitDirectory 配合路径判断即可实现：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 在
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;
}
});
处理符号链接与异常的健壮性技巧
默认情况下 walkFileTree 会跟随符号链接（可能造成循环或越界）。若需安全处理：
- 构造
FileTreeIterator时传入EnumSet.of(FileVisitOption.FOLLOW_LINKS)显式开启；不传则默认不跟随 - 在
visitFileFailed中统一捕获无法访问的条目（如损坏的软链、无权限目录），避免中断整个遍历 - 若需记录错误或统计失败数，可在 visitor 中定义成员变量并同步更新（注意多线程下需加锁或用
AtomicInteger）
替代方案提醒：Files.walk 与 Files.list 的适用边界
Files.walk 返回 Stream<Path> 更函数式，适合简单过滤+并行处理（如统计总大小），但它不提供访问顺序控制和目录进入/退出钩子；Files.list 仅列出一级内容，不递归。真正需要“边遍历边决策”（如动态跳过、提前终止、父子联动操作）时，walkFileTree 仍是不可替代的核心 API。
