$avg（平均值累加器）
最后更新：2026-10-09
$avg（平均值累加器）
$avg 是累加器，在 $group 中计算一组文档指定字段的平均值；也可在 $project 中计算数组元素的平均值。它忽略 null 和缺失字段，仅对数字求平均。常用于报表统计。注意：平均的对象是表达式结果，表达式可以很复杂。
| 分类 | 累加器 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $group: { _id: <键>, avg: { $avg: "$字段" } } } // 也可在 $project 中对数组求平均返回值：数值平均值（忽略 null 与缺失字段）
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $avg：按商品统计均价
db.sales.aggregate([
{ $group: { _id: '$item', avg: { $avg: '$price' } } }
])运行结果：
{ "_id": "Pen", "avg": 45.5 }
{ "_id": "Book", "avg": 12.0 }📌 注意事项
- 忽略 null、缺失和非数字值
- $project 中可对数组元素求平均
- 与 $sum、$count 组合可实现加权平均
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$avg 遇到缺失字段会怎样？
A忽略缺失和 null 值，只对存在的数字求平均。
Q$avg 能在 $project 里用吗？
A能，对数组字段求元素平均值，如 { $project: { a: { $avg: '$scores' } } }。
Q怎么算加权平均？
A用 $sum 累加值乘权重，再除以 $sum 权重，两个累加器组合实现。
