$eq（等于）
最后更新：2026-10-09
$eq（等于）
$eq 是查询比较操作符，选择字段值等于指定值的文档。它是 MongoDB 最常用的精确匹配条件：`{ age: { $eq: 21 } }` 等价于 `{ age: 21 }`，但 $eq 显式表达「相等」语义，且在聚合表达式中也扮演比较角色。注意 $eq 对类型敏感：字符串 "21" 不会匹配数字 21。另注意：显式写正则 { $eq: /pattern/ } 只匹配正则类型的值，与隐式 { field: /pattern/ } 的正则匹配行为不同。
| 分类 | 比较 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ <字段>: { $eq: <值> } }⚙️ 参数
| 字段 | 要匹配的文档字段名，可用点路径访问嵌套字段（如 "address.city"）。 |
|---|---|
| 值 | 要相等的值。可为字面量或表达式，对 BSON 类型敏感。 |
返回值：匹配的文档游标
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $eq：精确匹配 age 为 21 的文档
db.users.find({ age: { $eq: 21 } })
// 等价写法（隐式相等）
db.users.find({ age: 21 })
// 嵌套字段 + 类型敏感
db.users.find({ "address.city": { $eq: "Beijing" } })运行结果：
// 返回所有 age 恰好为 21（数字类型）的文档
{ "_id": ObjectId("..."), "name": "Alice", "age": 21, "address": { "city": "Beijing" } }📌 注意事项
- 对类型敏感：{ $eq: "21" } 不会匹配数字 21
- 标量值匹配数组字段时，任一元素相等即匹配（等价于 $elemMatch）；若值为数组，则要求整个数组完全匹配或包含与数组完全匹配的元素
- null 值匹配：$eq: null 会匹配字段缺失或字段为 null 的文档（与 $exists: false 不同）
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
Q$eq 和直接写 { age: 21 } 有什么区别？
A功能上完全等价，$eq 只是显式表达相等意图，方便在复杂查询中与 $and/$or 组合时保持可读性。
Q$eq 能匹配 null 吗？
A能。$eq: null 会同时匹配字段不存在或字段值为 null 的文档。若要只匹配 null 值本身，需配合 $type: 10（Null 类型）。
Q$eq 匹配数组时行为是什么？
A只要数组中有任意元素等于该值即匹配（等价于 $elemMatch）。如需整个数组完全相等，需直接写数组字面量或结合 $size 判断。
