$regexFind（正则查找第一个匹配）

最后更新：2026-10-09

$regexFind（正则查找第一个匹配）

$regexFind 在字符串中执行 Perl 兼容正则搜索，返回第一个匹配的结果文档（含 match、idx、captures 字段），无匹配时返回 null。regex 直接写模式字符串，options 可传 i（忽略大小写）、m（多行）等标志。它比 $regexMatch 多返回捕获组，适合需要提取匹配内容或捕获子组的场景。

📝 语法

{ $regexFind: { input: <字符串表达式>, regex: <正则模式>, options: <选项字符串> } }

⚙️ 参数

返回值：匹配文档 { match, idx, captures }；无匹配或 input 为 null 时返回 null。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $regexFind：提取联系方式中的 11 位手机号
 db.users.aggregate([
  { $project: { phone: { $regexFind: { input: '$contact', regex: '[0-9]{11}', options: 'i' } } } }
])

运行结果：

{ "_id": 1, "phone": { "match": "13800138000", "idx": 5, "captures": [] } }
{ "_id": 2, "phone": null }

📌 注意事项

• 无匹配时返回 null 而不是空文档，判断时注意
• captures 为捕获组数组，无捕获组时为空数组
• options 支持 i 忽略大小写、m 多行、x 忽略空白等

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们