db.collection.aggregate() 返回游标而非数组，因需支持大数据流式处理防oom；mongosh中自动显示前20条易造成误解；须显式调用.toarray()获取数组，否则无法使用map等数组方法。
不能直接“导出为数组”——aggregate 返回的是游标（cursor），不是原生 JavaScript 数组；你得主动调用 .toArray() 或等价方法才能拿到数组。
为什么 db.collection.aggregate() 不直接返回数组？
MongoDB 的聚合结果默认是游标，这是为了支持大数据量下的流式处理：不一次性加载全部结果到内存，避免 OOM。你在 mongosh 里看到的“打印出一堆文档”，其实是 shell 自动对前 20 条调用了 .toArray() 并格式化输出，容易误以为结果本身就是数组。
-
db.users.aggregate([{$match: {active: true}}])返回的是AggregationCursor对象，不是数组 - 直接
typeof result === 'object'，且没有.length、不能用map() - 必须显式调用
result.toArray()才能得到真正的Array
在 mongosh 中获取数组的正确写法
mongosh 是最常被用来快速验证管道的地方，但它的自动展开行为会掩盖真实类型。要拿到可操作的数组，必须显式转换：
- 同步方式（仅限 mongosh，不适用于 Node.js 驱动）：
db.users.aggregate([...]).toArray() - 异步方式（Node.js + MongoDB Driver）：
await cursor.toArray()，其中cursor = collection.aggregate([...]) - 错误示范：
const arr = db.users.aggregate([...]);—— 这个arr是游标，不是数组，后续arr.map(...)会报TypeError
示例：
const pipeline = [{$group: {_id: "$status", count: {$sum: 1}}}];<br>const result = db.orders.aggregate(pipeline).toArray(); // ✅ 得到数组<br>// result 是 [{_id: "shipped", count: 123}, {_id: "pending", count: 45}]
导出为数组时容易踩的坑
很多人想“把聚合结果导出成一个数组文件”，比如 JSON 文件里包着一个方括号开头的数组。这看似简单，但实际要注意三类陷阱：
- 内存风险：
.toArray()会把所有匹配文档一次性载入内存。千万避免在生产环境对百万级结果调用它——改用.forEach()流式处理或分页 - 类型丢失：用
mongoexport --type=csv导出含数组字段（如tags: ["a","b"]）时，CSV 会变成字符串"[\"a\",\"b\"]"或更糟（取决于选项），无法直接解析为数组；JSON 格式才保留结构 - 驱动差异：Node.js 驱动 v6+ 默认返回 Promise 游标，
collection.aggregate(pipeline).toArray()必须await；而旧版（v3.x）可能返回回调风格，混淆会导致undefined
真正需要“导出为数组”的场景，通常意味着你要在应用层进一步处理数据——这时别跳过游标这层抽象，先确认数据量、再决定是转数组还是保持流式迭代。否则，一个没加 .limit() 的聚合，可能让进程卡死几小时。
