$regexFindAll（正则查找全部匹配）
最后更新：2026-10-09
$regexFindAll（正则查找全部匹配）
$regexFindAll 在字符串中执行正则搜索并返回所有匹配的数组，每个元素含 match、idx、captures 字段，无匹配时返回空数组。它适合批量提取邮箱、链接、数字等重复出现的模式。与 $regexFind 相比，$regexFindAll 不返回 null，永远返回数组，可直接用 $size 统计匹配个数。
| 分类 | 字符串 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $regexFindAll: { input: <字符串表达式>, regex: <正则模式>, options: <选项字符串> } }⚙️ 参数
| input | 必填，要搜索的字符串。 |
|---|---|
| regex | 必填，Perl 兼容正则模式字符串。 |
| options | 可选，标志如 i、m。 |
返回值：匹配文档数组；无匹配返回空数组；input 为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $regexFindAll：提取正文中全部链接
db.posts.aggregate([
{ $project: { links: { $regexFindAll: { input: '$body', regex: 'https?://[a-z0-9.]+' } } } }
])运行结果：
{ "_id": 1, "links": [ { "match": "https://a.com", "idx": 10, "captures": [] }, { "match": "https://b.org", "idx": 32, "captures": [] } ] }📌 注意事项
- 无匹配返回空数组而非 null，可直接 $size 统计
- 匹配是全局的，不会因首次命中停止
- 大量文本上使用注意性能，可先用 $regexMatch 预筛
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q一个都匹配不到返回什么？
A返回空数组，不是 null。
Q怎么数匹配个数？
A$size 套在结果数组上即可。
Q和 $regexFind 什么区别？
A$regexFind 只返回第一个匹配（无匹配为 null），$regexFindAll 返回全部匹配数组。
