toArray()（游标转数组）
最后更新：2026-10-09
toArray()（游标转数组）
toArray()把find()等返回的游标全部取回并转换为JavaScript数组，语法为`db.users.find({ age: { $gt: 20 } }).toArray()`。调用后游标被完全消费，适合结果集较小、需要在客户端一次性处理的场景。结果集很大时会占用大量内存，此时建议改用forEach()流式遍历。
| 分类 | 游标 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
db.<集合>.find(<条件>).toArray()返回值：包含全部结果文档的数组。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// toArray：把成年用户查询结果转成数组
const users = db.users.find({ age: { $gte: 18 } }).toArray()
print('共 ' + users.length + ' 人')运行结果：
共 42 人📌 注意事项
- 一次性取回全部结果，大结果集会占用大量内存
- 调用后游标耗尽，无法再次遍历
- 结果超过BSON响应限制时服务器会报错，需配合limit()或分页
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Qfind返回的是数组吗？
A不是，find()返回游标。要数组就调用.toArray()，否则用forEach()等迭代方法。
QtoArray会一次性加载所有数据吗？
A是的，它会取回全部结果到客户端内存，数据量巨大时可能内存溢出，建议用forEach()流式处理。
QtoArray之后还能继续遍历游标吗？
A不能，toArray()之后游标已耗尽。需要多次处理请把结果保存成变量复用。
