$size（数组长度）
最后更新：2026-10-09
$size（数组长度）
$size 匹配数组字段长度恰好等于指定值的文档。`{ tags: { $size: 3 } }` 匹配恰好有 3 个标签的文档。查询中 $size 只支持精确等值，不能写 { $size: { $gt: 3 } }；范围查询需改用 $expr 加聚合 $size，或配合其他操作符。
| 分类 | 数组 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ <字段>: { $size: <长度> } }⚙️ 参数
| 字段 | 要匹配的数组字段名。 |
|---|---|
| 长度 | 数组元素个数，精确等值。 |
返回值：匹配的文档游标
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $size：恰好 3 个标签的文章
db.articles.find({ tags: { $size: 3 } })
// 大于等于 3 个标签（需 $expr）
db.articles.find({ $expr: { $gte: [{ $size: '$tags' }, 3] } })运行结果：
// 返回 tags 长度恰好为 3 的文章；第二个示例返回长度大于等于 3 的📌 注意事项
- 查询中只支持精确等值，不支持范围
- 范围查询用 $expr: { $size: '$tags' } 配合比较操作符
- $size 不匹配字段缺失的文档
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$size 能查数组长度大于某值吗？
A不能直接写。用 $expr: { $gt: [{ $size: '$tags' }, 3] }。
Q$size 匹配字段缺失的文档吗？
A不匹配，字段必须存在且为数组。
Q$size: 0 能查空数组吗？
A能，{ tags: { $size: 0 } } 匹配空数组；但字段缺失的文档不会匹配。
