$all（包含全部元素）
最后更新：2026-10-09
$all（包含全部元素）
$all 匹配数组字段包含给定数组中所有元素的文档。`{ tags: { $all: ['mongodb', 'database'] } }` 要求 tags 同时包含这两个值，顺序无关。与 $in 的关键区别：$in 只要有一个匹配即返回，$all 要求全部包含。适合「同时具备多个标签」的筛选。
| 分类 | 数组 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ <字段>: { $all: [ <值1>, <值2>, ... ] } }⚙️ 参数
| 字段 | 要匹配的数组字段名。 |
|---|---|
| 值数组 | 必须全部包含的值列表。 |
返回值：匹配的文档游标
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $all：tags 同时包含 mongodb 和 database
db.articles.find({ tags: { $all: ['mongodb', 'database'] } })
// 与 $in 对比：$in 只要包含其一
db.articles.find({ tags: { $in: ['mongodb', 'database'] } })运行结果：
// 第一个示例只返回同时含两个标签的文章；第二个返回含任一标签的📌 注意事项
- 顺序无关：['mongodb', 'database'] 与 ['database', 'mongodb'] 等价
- 与 $in 语义相反方向：$all 是全包含，$in 是任一匹配
- 空数组 $all: [] 匹配所有文档（含无字段的）
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$all 和 $in 有什么区别？
A$in 匹配数组中任意一个值即可，$all 要求数组中所有值都出现。
Q$all 对非数组字段有效吗？
A对非数组字段，$all 等价于 $eq（单值比较）。
Q$all 空数组会怎样？
A$all: [] 匹配所有文档，包括字段缺失的文档。
