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

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) 校验。










