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

老强吖_4231

老强吖_4231

2026-04-30

284人浏览

原创

getPathMatcher()仅支持glob:和regex:两种语法;glob:支持*(同层多字符)、?(单字符)、[a-z](字符类),不支持**或跨目录匹配;regex:用于复杂路径匹配,需传全路径字符串。

怎么利用 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) 校验。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11417

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8522

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7332

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3009

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20251

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习