当前位置:首页 > 文章列表 > 文章 > java教程 > 可以使用 FileSystems.getDefault().getPathMatcher() 来实现类似通配符的文件名匹配,主要通过定义一个符合 glob 语法的模式字符串。以下是详细步骤和示例代码:✅ 一、理解 PathMatcherPathMatcher 是 Java NIO 中用于匹配路径的接口,它支持 glob 模式(类似于 shell 中的通配符),例如:*.txt:匹配所有 .txt

可以使用 FileSystems.getDefault().getPathMatcher() 来实现类似通配符的文件名匹配,主要通过定义一个符合 glob 语法的模式字符串。以下是详细步骤和示例代码:✅ 一、理解 PathMatcherPathMatcher 是 Java NIO 中用于匹配路径的接口,它支持 glob 模式(类似于 shell 中的通配符),例如:*.txt:匹配所有 .txt

2026-05-14 20:06:51 0浏览 收藏
Java NIO 的 `PathMatcher` 是一个轻量高效的路径匹配工具,支持 `glob:` 和 `regex:` 两种语法:`glob:` 适用于简单文件名匹配(如 `*.txt`、`??.java`),但严格限制为单层通配(不支持 `**` 递归)、路径分隔符必须用 `/`,且 `matches()` 实际只作用于文件名而非全路径;而 `regex:` 则用于复杂场景,如跨目录匹配、路径段模式或否定逻辑,但需注意字符串转义、分隔符兼容性及性能开销。正确使用的关键在于理解匹配目标(文件名 vs 全路径)、避免重复创建实例、配合 `getFileName()` 提取匹配单元,并在递归遍历时优先选用 `Files.walk()` 或 `Files.find()` 配合显式文件名提取——掌握这些细节,才能让文件筛选既精准又高效。

怎么利用 FileSystems.getDefault().getPathMatcher() 实现类似通配符的文件名匹配

getPathMatcher() 支持哪些通配语法?

FileSystems.getDefault().getPathMatcher() 不支持 Shell 风格的 **(递归 glob),也不支持正则表达式裸写——它只认两种 scheme:glob:regex:。默认前缀是 glob:,所以 "*.txt" 等价于 "glob:*.txt"。常见误区是以为 **/*.java 能跨目录匹配,实际会抛 java.nio.file.InvalidPathException

真正可用的 glob 元符只有三个:

  • *:匹配当前目录下任意数量非 / 字符(不跨目录)
  • ?:匹配单个非 / 字符
  • [a-z][!0-9]:字符类,注意不支持 [^0-9]

路径分隔符必须用 /(Windows 上也强制用正斜杠),例如 "glob:src/main/**/*.java" 是非法的;正确写法是分两步:先用 Files.walk() 遍历目录,再对每个 Path.getFileName() 单独 matcher。

如何正确构造并复用 PathMatcher 实例?

每次调用 getPathMatcher("glob:*.log") 都会新建对象,但 matcher 本身是无状态的,可以安全复用。别在循环里反复创建——尤其在过滤成千上万个文件时,实测能减少 10%+ GC 压力。

典型用法:

PathMatcher matcher = FileSystems.getDefault().getPathMatcher("glob:*.sql");
for (Path path : paths) {
    if (matcher.matches(path.getFileName())) { // 注意:传的是文件名,不是全路径
        System.out.println(path);
    }
}

关键点:

  • matcher.matches() 接收的是 Path 对象,但逻辑上只检查其最后一段(即文件名),和路径层级无关
  • 如果想匹配完整路径(如 "config/dev/*.yml"),得先用 path.toString()path.normalize() 转成字符串,再用 regex: scheme(见下一条)
  • matcher 实例线程安全,可作为类字段或静态常量缓存

什么时候必须切到 regex: scheme?

当需要匹配路径中某一段含特定模式(比如 "logs/error-2024-*.log")、或要跨级匹配(如 "**/target/**/*.jar")、或需否定逻辑(如 “非 .tmp 结尾”)时,glob: 无能为力,必须用 regex:

注意:regex: 接收的是路径的字符串表示(path.toString()),且默认以 ^ 开头、$ 结尾,所以写 "regex:.*\\.log" 就够了,不用手动加锚点。

示例:

PathMatcher matcher = FileSystems.getDefault().getPathMatcher(
    "regex:.*[/\\\\]target[/\\\\].*\\.jar"); // 同时兼容 / 和 \ 分隔符
if (matcher.matches(path)) { ... }

坑点:

  • Java 字符串里反斜杠要双写,正则里又要双写,所以 \\ 写成 "\\\\"
  • Windows 路径可能含 \,用 path.toString().replace('\\', '/') 统一更稳妥
  • regex 匹配开销比 glob 高,高频场景建议预编译 Pattern 缓存,而非依赖 PathMatcher

为什么 Files.find() + PathMatcher 组合容易漏文件?

直接写 Files.find(root, 3, (p, a) -> matcher.matches(p)) 很诱人,但错在:matcher 检查的是全路径 p,而 glob 规则(如 "*.md")只设计用于匹配文件名。结果是只有根目录下的 .md 文件被命中,子目录里的全失效。

正确姿势是显式提取文件名:

Files.find(root, 3,
    (p, a) -> matcher.matches(p.getFileName())) // ← 关键!用 getFileName()
    .forEach(System.out::println);

或者用 Files.walk() 手动控制:

try (Stream<path> stream = Files.walk(root)) {
    stream.filter(p -> !Files.isDirectory(p))
          .filter(p -> matcher.matches(p.getFileName()))
          .forEach(...);
}</path>

额外提醒:如果 root 本身是文件(非目录),Files.walk() 会抛 NotDirectoryException,务必提前 Files.isDirectory(root) 校验。

到这里,我们也就讲完了《可以使用 FileSystems.getDefault().getPathMatcher() 来实现类似通配符的文件名匹配,主要通过定义一个符合 glob 语法的模式字符串。以下是详细步骤和示例代码:✅ 一、理解 PathMatcherPathMatcher 是 Java NIO 中用于匹配路径的接口,它支持 glob 模式(类似于 shell 中的通配符),例如:*.txt:匹配所有 .txt 文件??.java:匹配两个字符后缀为 .java 的文件data/*:匹配 data 目录下的所有文件✅ 二、创建 PathMatcher import java.nio.file.*; import java.io.IOException; public class PathMatcherExample { public static void main(String[] args) throws IOException { // 定义 glob 模式 String pattern = "data/*.txt"; // 匹配 data 目录下所有 .txt 文件 // 获取默认文件系统 FileSystem fs = FileSystems.getDefault(); // 创建 PathMatcher 实例 PathMatcher matcher = fs.getPathMatcher("glob:" + pattern); // 遍历目录并检查文件是否匹配 Path dir = Paths.get("data"); Files.list(dir) .filter(path -> matcher.matches(path)) .forEach(System.out::println); } } ``》的内容了。个人认为,基础知识的学习和巩固,是为了更好的将其运用到项目中,欢迎关注golang学习网公众号,带你了解更多关于的知识点!

微信网页版安全登录入口及最新版地址微信网页版安全登录入口及最新版地址
上一篇
微信网页版安全登录入口及最新版地址
双11花呗提额券使用方法及领取教程
下一篇
双11花呗提额券使用方法及领取教程
查看更多
最新文章
资料下载
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • ChatExcel酷表:告别Excel难题,北大团队AI助手助您轻松处理数据
    ChatExcel酷表
    ChatExcel酷表是由北京大学团队打造的Excel聊天机器人,用自然语言操控表格,简化数据处理,告别繁琐操作,提升工作效率!适用于学生、上班族及政府人员。
    4517次使用
  • Any绘本:开源免费AI绘本创作工具深度解析
    Any绘本
    探索Any绘本(anypicturebook.com/zh),一款开源免费的AI绘本创作工具,基于Google Gemini与Flux AI模型,让您轻松创作个性化绘本。适用于家庭、教育、创作等多种场景,零门槛,高自由度,技术透明,本地可控。
    4867次使用
  • 可赞AI:AI驱动办公可视化智能工具,一键高效生成文档图表脑图
    可赞AI
    可赞AI,AI驱动的办公可视化智能工具,助您轻松实现文本与可视化元素高效转化。无论是智能文档生成、多格式文本解析,还是一键生成专业图表、脑图、知识卡片,可赞AI都能让信息处理更清晰高效。覆盖数据汇报、会议纪要、内容营销等全场景,大幅提升办公效率,降低专业门槛,是您提升工作效率的得力助手。
    4743次使用
  • 星月写作:AI网文创作神器,助力爆款小说速成
    星月写作
    星月写作是国内首款聚焦中文网络小说创作的AI辅助工具,解决网文作者从构思到变现的全流程痛点。AI扫榜、专属模板、全链路适配,助力新人快速上手,资深作者效率倍增。
    6601次使用
  • MagicLight.ai:叙事驱动AI动画视频创作平台 | 高效生成专业级故事动画
    MagicLight
    MagicLight.ai是全球首款叙事驱动型AI动画视频创作平台,专注于解决从故事想法到完整动画的全流程痛点。它通过自研AI模型,保障角色、风格、场景高度一致性,让零动画经验者也能高效产出专业级叙事内容。广泛适用于独立创作者、动画工作室、教育机构及企业营销,助您轻松实现创意落地与商业化。
    5104次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码