搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

micromatch/picomatch

开发工具

把 glob 模式编译成匹配函数的 JavaScript 库,支持通配符、extglob、POSIX 字符类和正则语法,零依赖。

1,332
212
JavaScript
MIT
创建于 8 年前

项目介绍

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: true POSIX 字符类。
  • 默认会把 +(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 生成,更新于 ,以项目官方文档为准。