$push（数组收集累加器）
最后更新：2026-10-09
$push（数组收集累加器）
$push 是累加器，在 $group 中把组内每个文档的指定表达式结果追加到一个数组中，顺序与文档进入 $group 的顺序一致（通常不保证稳定）。它能把分组明细收集到一条文档里。注意：需要稳定顺序时应先 $sort。
| 分类 | 累加器 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $group: { _id: <键>, items: { $push: "$字段" } } }返回值：组内所有表达式结果组成的数组
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $push：把每位客户的商品收集成数组
db.orders.aggregate([
{ $group: { _id: '$cust_id', items: { $push: '$item' } } }
])运行结果：
{ "_id": "A123", "items": ["Pen", "Book"] }📌 注意事项
- 顺序与输入顺序相关，不保证稳定
- 配合 $sort 前置可保证组内顺序
- 可用 $slice 截取部分元素；去重需求用 $addToSet
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$push 结果顺序稳定吗？
A不严格保证，需要稳定顺序时先在管道里 $sort。
Q$push 和 $addToSet 有什么区别？
A$push 保留重复元素，$addToSet 自动去重。
Q怎么只收集前几个元素？
A$push 后再用 $slice 截取，或 $sort 加 $limit 后 $group。
