Java中递归删除非空目录应优先使用Files.walkFileTree配合SimpleFileVisitor，它自底向上后序遍历、自动处理符号链接与权限异常；次选手动递归加deleteIfExists，需自行处理只读属性和异常。
Java 中递归删除非空目录，核心是先遍历并删除所有子文件和子目录，再删除自身。JDK 7+ 推荐用 Files.walkFileTree() 配合 SimpleFileVisitor，安全、高效、自动处理符号链接和权限异常。
使用 Files.walkFileTree（推荐）
这是最健壮的方式，能正确处理深层嵌套、只读文件、权限不足等边界情况：
- 从叶子节点开始向上删除（后序遍历），避免“目录非空”错误
- 自动跳过无法访问的条目，可通过重写
visitFileFailed控制行为 - 支持自定义异常处理，不因单个文件失败而中断整个删除
示例代码：
import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
public class DirDeleter {
public static void deleteDirectory(Path dir) throws IOException {
if (!Files.exists(dir)) return;
Files.walkFileTree(dir, new SimpleFileVisitor<path>() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)
throws IOException {
Files.delete(file);
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult postVisitDirectory(Path dir, IOException exc)
throws IOException {
if (exc != null) throw exc;
Files.delete(dir);
return FileVisitResult.CONTINUE;
}
});
}
}</path>
使用 Files.deleteIfExists + 递归（基础版）
适合简单场景，但需手动处理异常和只读文件：
- 先检查是否为目录，若是则递归删除每个子项
- 调用
Files.delete()删除文件或空目录；若失败，可先设为可写再删 - 注意：不能直接对非空目录调用
Files.delete()，会抛DirectoryNotEmptyException
示例片段：
public static void deleteRecursively(Path path) throws IOException {
if (!Files.exists(path)) return;
if (Files.isDirectory(path)) {
for (Path child : Files.list(path).toList()) {
deleteRecursively(child);
}
}
// 删除前确保可写（尤其 Windows 下只读文件）
Files.setAttribute(path, "dos:readonly", false, LinkOption.NOFOLLOW_LINKS);
Files.delete(path);
}
注意事项与常见问题
实际使用中容易忽略的关键点：
-
不要用
File.delete()：该方法已过时，不抛详细异常，且对只读文件在 Windows 上静默失败 -
避免循环引用：如果目录包含符号链接指向父级或自身，
walkFileTree默认会检测并跳过，更安全 -
权限与只读属性：Linux/macOS 注意执行权限，Windows 特别关注
readonly属性，删除前建议清除 -
大目录性能：
walkFileTree是流式遍历，内存友好；避免用Files.list().collect(Collectors.toList())加载全部路径到内存
补充：一行命令式删除（Java 11+）
如果项目允许 Java 11+，可用简洁写法（原理仍是 walkFileTree）：
try {
Files.walk(dir)
.sorted(Comparator.reverseOrder())
.forEach(path -> {
try { Files.delete(path); }
catch (IOException e) { throw new UncheckedIOException(e); }
});
} catch (UncheckedIOException e) {
throw e.getCause();
}
注意：sorted(Comparator.reverseOrder()) 确保子项优先于父项被处理，但不如 SimpleFileVisitor 精确控制异常，仅作快速脚本使用。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
