当前位置:首页 > 文章列表 > 文章 > 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 stream = Files.walk(root)) {
    stream.filter(p -> !Files.isDirectory(p))
          .filter(p -> matcher.matches(p.getFileName()))
          .forEach(...);
}

额外提醒:如果 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推荐
  • ljg-skills -
    ljg-skills
    ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
    2917次使用
  • MELO音乐 - AI 音乐生成平台,支持多模态创作能力
    MELO音乐
    MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
    2702次使用
  • UniScribe - AI 免费在线音视频转文字平台
    UniScribe
    UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
    2632次使用
  • 剧云 - 免费 AI 智能中文剧本创作平台
    剧云
    剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
    2869次使用
  • 万象有声 - AI 一站式有声内容创作平台
    万象有声
    万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
    2808次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码