$regexMatch（正则匹配判断）

最后更新：2026-10-09

$regexMatch（正则匹配判断）

$regexMatch 判断字符串是否匹配正则，返回布尔值 true 或 false，是最轻量的正则表达式操作符，适合做条件过滤、数据清洗校验。它只做「是否匹配」判断，不返回匹配内容；需要提取内容时用 $regexFind。options 支持 i、m、s、x 等标志。input 为 null 或缺失时返回 null。

📝 语法

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

⚙️ 参数

返回值：匹配返回 true，否则 false；input 为 null 时返回 null。

▶ 示例

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

// $regexMatch：判断邮箱是否 Gmail（忽略大小写）
 db.users.aggregate([
  { $project: { isGmail: { $regexMatch: { input: '$email', regex: '@gmail\\.com$', options: 'i' } } } }
])

运行结果：

{ "_id": 1, "isGmail": true }
{ "_id": 2, "isGmail": false }

📌 注意事项

• 返回布尔值，可直接用于 $match 的 $expr
• regex 传字符串模式，锚点 ^ 和 $ 可用
• 只判断是否匹配，需要提取内容时用 $regexFind

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们