$count（计数累加器）
最后更新：2026-10-09
$count（计数累加器）
$count 是累加器，统计 $group 中组内文档的数量，输出数值，自 MongoDB 5.0 起可用。它是 { $sum: 1 } 的等价简写，语义更清晰。注意与管道阶段 $count 区分：阶段版输出 { count: N } 文档并结束管道，累加器版返回组内计数的数值。
| 分类 | 累加器 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $group: { _id: <键>, n: { $count: {} } } }返回值：组内文档数量的整数
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $count：统计各状态的订单数
db.orders.aggregate([
{ $group: { _id: '$status', n: { $count: {} } } }
])运行结果：
{ "_id": "A", "n": 25 }
{ "_id": "B", "n": 10 }📌 注意事项
- 等价于 { $sum: 1 }
- 与阶段 $count 不同，它不结束管道
- 无需字段表达式，组内所有文档都计入
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$count 累加器和 $count 阶段有什么区别？
A累加器在 $group 内返回组内数量；阶段输出单条 { count: N } 文档。
Q$count 累加器有参数吗？
A没有，直接写 { $count: {} }。
Q什么时候用 $count 而不是 $sum: 1？
A语义更清晰，性能相同，推荐优先使用。
