micromatch/picomatch
开发工具把 glob 模式编译成匹配函数的 JavaScript 库,支持通配符、extglob、POSIX 字符类和正则语法,零依赖。
项目介绍
Picomatch 把 glob 模式转换成匹配函数,让 JS 代码用 *.js、**/*.js、!(foo).!(bar) 这类模式检测路径或文件名。它支持通配符 * 和 ?、跨目录的 **、extglob、逗号分隔的花括号、POSIX 字符类、前导 ! 取反,以及用反斜杠或引号转义特殊字符,运行时无依赖 高级 globbing。
它面向需要在工具链内部做文件名筛选的开发者,比如文件监听、构建流程、lint、测试运行器;也适合想自己把模式编译成正则的场景。主入口只有一个函数,同时提供 isMatch、matchBase、parse、scan、makeRe、toRegex 等辅助方法 API 文档。
安装与第一个匹配器
在 CommonJS 或带打包器的项目里从 npm 安装:
npm install --save picomatch
然后创建匹配器并复用它做多次判断;先编译一次、之后反复调用返回的函数,是文件监听和批量匹配的推荐用法 使用示例:
const picomatch = require('picomatch');
const isMatch = picomatch('*.js');
console.log(isMatch('abcd')); // false
console.log(isMatch('a.js')); // true
console.log(isMatch('a.md')); // false
console.log(isMatch('a/b.js')); // false
在没有 Node.js 路径探测的环境里,picomatch/posix 提供同样的 API,默认按 POSIX 路径处理;在选项里传 windows: true 可同时接受反斜杠分隔符 主 API。
影响匹配结果的常用选项
常用项包括 dot(匹配点文件)、nocase(忽略大小写)、basename / matchBase(只匹配文件名部分)、ignore(排除模式)、bash(更严格的 Bash 规则)、windows、posix、noextglob、noglobstar、nonegate。onMatch、onIgnore、onResult 回调会返回每次判断的细节 选项表。
使用约束与已知差异
**只有在整个路径段就是**时才跨越路径分隔符,foo**/bar等价于foo*/bar。Picomatch 中单个*不跨路径分隔符,而 Bash 对嵌套路径会跨 与 Bash 的差异。- 花括号只支持逗号列表,如
{a,b};{01..03}这类范围和步长不会自动展开,需要高级花括号功能时应使用 micromatch 花括号。 - POSIX 字符类默认关闭,需设置
posix: truePOSIX 字符类。 - 默认会把
+(a|aa)这类有风险的嵌套量词 extglob 当作字面量处理,而不是编译成正则;可用maxExtglobRecursion放宽限制 选项表。 - 输入字符串超过
maxLength(默认 65536)会抛错。 - 需要 JavaScript 运行时;README 记录的是 CommonJS 用法和无依赖的 POSIX 构建。许可证为 MIT 许可证。
HotRepo 点评
Picomatch 在 2026-11-19 进入 JavaScript 日榜,最好名次第 6,当日新增 3 个 Star,这是现有数据里唯一一次记录;没有连续多天的序列,无法据此判断趋势。这次单日上榜更符合一个长期存在的基础库:2018 年创建、1,330 Star,并不是新项目。README 自带的基准表显示,在星号、globstar 和花括号范围等场景下 Picomatch 的处理速度高于 minimatch,大范围展开时差距尤其明显;不过这些是项目在自选模式上公布的数字,只能说明它把优化重点放在匹配编译上,不应视为独立结论。用用户输入构造模式时,extglob 递归上限和输入长度限制这两项保护值得留意。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。