本文介绍使用 Java NIO.2 的 PathMatcher 和 Files API，精准删除指定路径集合中的文件/目录，同时安全跳过符合 glob 模式（如 *.txt）的项，避免误删，兼顾健壮性与可读性。
本文介绍使用 java nio.2 的 `pathmatcher` 和 `files` api，精准删除指定路径集合中的文件/目录，同时安全跳过符合 glob 模式（如 `*.txt`）的项，避免误删，兼顾健壮性与可读性。
在实际项目清理逻辑中（如构建后清理、缓存回收或测试资源重置），常需批量删除一组路径，但必须保留特定模式的文件或目录——例如保留所有 .txt 日志、.properties 配置或 build/ 目录。此时，简单遍历 + FileUtils.deleteQuietly() 无法原生支持“条件排除”，易导致关键资源被误删。
Java 7 引入的 NIO.2 提供了强大且平台无关的路径匹配能力。核心在于 FileSystem.getPathMatcher(String)，它支持 glob: 方案（如 glob:**/*.txt），可精确描述通配规则，并与 Path 对象高效比对。
以下为完整、生产就绪的实现方案：
✅ 推荐实现（基于 NIO.2，线程安全、异常可控）
import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.Set;
public class SafeCleaner {
/**
* 删除 cleanablePaths 中所有项，但跳过匹配 excludeGlobPattern 的路径
* @param cleanablePaths 待清理的文件/目录路径集合（绝对路径）
* @param excludeGlobPattern Glob 模式，如 "glob:**/*.txt" 或 "glob:config/**"
*/
public static void deleteExcept(Set<Path> cleanablePaths, String excludeGlobPattern) {
// 创建 PathMatcher（注意：glob 模式必须以 "glob:" 开头）
PathMatcher matcher = FileSystems.getDefault().getPathMatcher(excludeGlobPattern);
for (Path path : cleanablePaths) {
try {
// 标准化路径并检查是否匹配排除模式（区分大小写，按系统默认规则）
Path normalized = path.toRealPath(LinkOption.NOFOLLOW_LINKS);
if (matcher.matches(normalized)) {
System.out.println("SKIP (excluded by pattern): " + normalized);
continue;
}
// 安全删除：文件直接删；目录递归删（含子项）
if (Files.isDirectory(path)) {
Files.walkFileTree(path, 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) {
Files.delete(dir);
return FileVisitResult.CONTINUE;
} else {
throw exc;
}
}
});
} else {
Files.deleteIfExists(path);
}
System.out.println("DELETED: " + path);
} catch (IOException e) {
System.err.println("Failed to delete " + path + ": " + e.getMessage());
}
}
}
}? 关键说明与最佳实践
-
Glob 模式语法：必须显式添加 glob: 前缀。常见写法：
立即学习“Java免费学习笔记（深入）”；
- glob:*.txt → 当前目录下所有 .txt 文件
- glob:**/*.log → 所有子目录中的 .log 文件（递归）
- glob:build/** → 整个 build/ 目录及其全部内容（但本例中会跳过该目录）
- glob:config?/app.properties → 匹配 config1/app.properties、configA/app.properties 等
路径标准化很重要：调用 toRealPath(LinkOption.NOFOLLOW_LINKS) 可消除符号链接、..、. 等歧义，确保匹配逻辑可靠；若需保留符号链接行为，可改用 normalize()，但需自行处理循环引用风险。
不依赖 Apache Commons IO：本方案纯 JDK 实现（Java 7+），无第三方依赖，减少类路径污染与版本冲突。
异常处理更精细：相比 deleteQuietly() 的静默失败，此处捕获 IOException 并打印错误，便于调试；你也可根据需要抛出自定义异常或记录到 SLF4J。
性能提示：若 cleanablePaths 极大（>10k），建议结合 ForkJoinPool 并行处理，但需注意文件系统 I/O 并发瓶颈；一般场景下顺序执行已足够高效。
⚠️ 注意事项
- PathMatcher 默认区分大小写（Windows 下通常不敏感，Linux/macOS 敏感）。如需跨平台一致的不区分大小写匹配，请改用正则模式：regex:(?i).*\.txt$（需将 glob: 替换为 regex:）。
- 切勿在 excludeGlobPattern 中使用危险通配符如 glob:**（无限制递归），应始终限定作用域（如 glob:target/**）。
- 生产环境建议在执行前增加 dry-run 模式（仅打印将删除/跳过的路径），验证逻辑正确性。
通过以上方式，你不仅能安全、清晰地表达“删除除某模式外的所有项”这一业务意图，还能获得更好的可维护性与跨平台兼容性。
