$regexReplace（正则替换）
最后更新：2026-10-09
$regexReplace（正则替换）
$regexReplace 用正则匹配文本并替换为指定字符串，是聚合管道中的高级文本清洗工具。replacement 中可用 $1、$2 引用捕获组，实现抽取重组。options 支持 i、m、x 等标志。它与 $replaceAll 的区别：$replaceAll 只能做字面量替换，$regexReplace 支持模式匹配。MongoDB 4.4 引入。input 为 null 时返回 null。
| 分类 | 字符串 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $regexReplace: { input: <字符串表达式>, regex: <正则模式>, replacement: <替换字符串>, options: <选项字符串> } }⚙️ 参数
| input | 必填，要处理的字符串。 |
|---|---|
| regex | 必填，Perl 兼容正则模式字符串。 |
| replacement | 必填，替换字符串，可用 $1、$2 引用捕获组。 |
| options | 可选，标志如 i、m、x。 |
返回值：替换后的字符串；input 为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $regexReplace：手机号中间 4 位打码
db.users.aggregate([
{ $project: { masked: { $regexReplace: { input: '$phone', regex: '(\\d{3})\\d{4}(\\d{4})', replacement: '$1****$2' } } } }
])运行结果：
{ "_id": 1, "masked": "138****8000" }
{ "_id": 2, "masked": "139****1234" }📌 注意事项
- replacement 中 $1、$2 引用捕获组；写字面 $ 需转义
- 与 $replaceAll 的区别：$replaceAll 字面替换，$regexReplace 模式替换
- 未匹配到任何内容时返回原字符串
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q替换串里怎么引用捕获组？
A用 $1、$2 按捕获组顺序引用。
Q没匹配到会怎样？
A返回原字符串不变。
Q和 $replaceAll 选哪个？
A模式匹配用 $regexReplace，纯字面替换用 $replaceAll 更快。
