$count必须作为pipeline最后一个stage，它将输入重写为仅含计数字段的单文档，不支持分组、表达式或与其他聚合阶段混用，仅适用于全局总数统计。
为什么 $count 不能直接接在 $match 后面就完事？
很多人写完 $match 就直接跟 $count，结果发现返回空数组或报错——不是语法错，而是 $count 必须作为 pipeline 的最后一个 stage，且它会把整个输入文档重写为一个仅含计数字段的单文档。如果前面用了 $project 或 $group，再用 $count 就容易丢字段或逻辑错位。
-
$count只接受一个字符串参数（字段别名），不支持表达式或嵌套路径 - 它等价于
{$group: {_id: null, count: {$sum: 1}}}，但更简洁；不过一旦你需要同时返回其他聚合值（比如平均值、去重数），就不能只靠$count - 如果 pipeline 中有
$limit或$skip，$count统计的是它们之后的文档数——这点常被忽略，导致结果比预期少
$count 和 $group + $sum 该怎么选？
单纯要总数时，$count 更直观；但只要需求稍复杂，比如“按状态分组后各自计数”，就必须换用 $group。
- 要总数量：用
{$count: "total"}，输出形如{total: 127} - 要分组计数：必须用
{$group: {_id: "$status", count: {$sum: 1}}}，$count不支持_id分组 -
$count在 MongoDB 5.0+ 才支持作为 stage 使用；老版本只能用$group模拟 - 性能上两者差异不大，但
$count少写几个字，不易拼错$sum
常见错误：在 $facet 里误用 $count
$facet 内部每个子 pipeline 是独立上下文，但新手常把 $count 写成 {$count: "cnt"} 后忘了它会覆盖整个子 pipeline 输出——导致其他字段丢失，或者和同级的 $group 结果结构不一致。
- 正确写法示例：
{$facet: { "byType": [{$group: {_id: "$type", count: {$sum: 1}}}], "totalCount": [{$count: "total"}] }} - 错误写法：
{$count: "total"}单独放在$facet外层——这会导致语法错误，因为$facet要求每个子 pipeline 都是数组 - 如果子 pipeline 里既要计数又要保留原始字段，不能用
$count，得改用$group+$sum+$first等组合
Node.js 驱动里调用 $count 的实际写法
MongoDB Node.js 驱动（v4+）对 $count 支持良好，但要注意它返回的是数组（即使只有一条），且字段名是你指定的字符串，不是固定叫 count。
- 示例代码：
collection.aggregate([ {$match: {status: "active"}}, {$count: "activeCount"} ]).toArray() - 返回结果是
[{activeCount: 42}]，不是{activeCount: 42}，别直接解构漏掉数组 - 如果匹配结果为空，
$count返回[{activeCount: 0}]，不是空数组，这点和find().countDocuments()行为不同 - 别混用：不要在同一个 aggregate 里既用
$count又用$group，除非你清楚 pipeline 执行顺序和输出结构
$count 只解决其中一种，而且它一出手，前面所有字段就都没了。
