$replaceWith（替换为）

最后更新：2026-10-09

$replaceWith 与 $replaceRoot 基本一致：用指定表达式的结果替换整个文档，但表达式结果为 null 或缺失时保留原文档而不是报错。适合能提级就提级、提不了就原样保留的场景。其余字段语义与 $replaceRoot 相同。

📝 语法

{ $replaceWith: <文档表达式> }

文档表达式	求值后替换整个文档的表达式，可为 null 或缺失。

返回值：替换后的文档流（结果为 null 时保留原文档）

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

// $replaceWith：有 detail 就提升，否则保留原文档
db.orders.aggregate([
  { $replaceWith: '$detail' }
])

运行结果：

// 有 detail 的订单输出 detail 内容，没有的原样输出

更多实战案例即将上线，敬请期待。

Q$replaceWith 和 $replaceRoot 区别？

A$replaceWith 结果为 null 时输出原文档；$replaceRoot 此时报错。

Q怎么合并多个字段为新文档？

A用 $mergeObjects 组合，如 { $replaceWith: { $mergeObjects: ['$a', '$b'] } }。

Q$replaceWith 会保留 _id 吗？

A不保留，除非表达式里显式包含 _id。

Web-Tutorial 技术团队

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