Glob 模式测试器
Glob 模式
路径
结果
语法速查表
- *
- 单个路径段内的任意字符(不匹配 /)
- **
- 任意数量的路径段,包括零个
- ?
- 恰好一个字符(不含 /)
- [abc]
- 集合中的一个字符;[a-z] 表示范围,[!abc] 表示取反
- {a,b}
- 候选项,例如 *.{ts,tsx},或范围如 {1..3}
- !(x)
- 除所列候选项之外的任何内容,例如 !(*.test).ts
- +(x)
- 一个或多个所列候选项,例如 +(a|b)
- @(x)
- 恰好一个所列候选项,例如 @(js|ts)
技术详情
Glob 模式测试器的工作原理
工具的功能
Glob 模式测试器会针对文件路径列表检查一个或多个 glob 模式,并将每个路径标记为匹配或不匹配。模式按顺序以 gitignore 风格评估:以 ! 开头的模式会从结果中移除路径,后面的模式会覆盖前面的模式。每个结果都会显示最终由哪个模式决定,你还可以查看 picomatch 为每个模式编译出的正则表达式。所有操作都在浏览器中运行。
常见开发场景
开发者使用 glob 测试器来调试 tsconfig.json、ESLint 和 Prettier 忽略文件、Jest 和 Vitest 测试模式、GitHub Actions 路径过滤器、打包工具配置以及 CI 缓存键中的包含与排除列表。它也适合在提交前检查 .gitignore 和 .dockerignore 规则,以及弄清构建工具为何会选中或悄悄跳过某个文件。
数据格式、类型或变体
默认模式使用 picomatch(micromatch 和许多构建工具背后的匹配器),支持 * 和 ** 通配符、? 单字符、[abc] 字符类、{a,b} 大括号候选项,以及 !(x)、+(x) 和 @(x) 等 extglob。可选的 .gitignore 模式增加了 gitignore 规则:不含斜杠的模式可匹配任意深度,开头的斜杠表示锚定到根目录,结尾的斜杠仅匹配目录。子目录中的 .gitignore 文件以及“父目录被排除后其中的文件无法再被重新包含”的规则不在模拟范围内。
常见陷阱与最佳实践
除非开启 dot 选项或显式写出点,否则通配符不会匹配点文件,因此 **/* 会跳过 .github 和 .env。* 永远不会跨越斜杠,所以 *.ts 只匹配顶层文件;要匹配任意深度请使用 **/*.ts。否定的顺序很重要:! 模式只会排除之前模式匹配到的路径。Glob 匹配默认区分大小写,而且不同工具(minimatch、micromatch、shell 通配、.gitignore)之间存在细微差异,因此请在你实际部署所用的工具中确认结果。