$filter是聚合阶段轻量筛选数组的首选方式，它保留数组结构、避免$unwind开销，而$elemMatch仅返回首个匹配项且非真正过滤；$filter必须用于$project等聚合阶段，input须为数组并建议用$ifNull兜底，性能取决于前置$match缩小数据集。
直接用 $filter 在 $project 阶段做数组筛选，是最轻量、最可控的方式——它不改变文档结构，不触发数组展开，也不需要额外的 $unwind 开销。
为什么不用 $elemMatch 投影？
$elemMatch 看似简单，但它只返回数组中「第一个」匹配的元素，哪怕你有 5 个符合条件的子文档，也只会吐出 1 个。
- 比如查询
{ "items": { "$elemMatch": { "price": { "$gt": 100 } } } }，结果里items字段永远是单个对象，不是数组 - 它本质是「匹配+截断」，不是「过滤+保留」
- 如果你后续要遍历或统计匹配数量，
$elemMatch会掩盖真实数据分布
$filter 必须配合 $project 使用
$filter 是聚合操作符，不能单独出现在 find() 的 projection 参数里；它只能嵌在聚合管道的 $project、$addFields 或其他支持表达式的 stage 中。
- 错误写法：
db.collection.find({}, { items: { $filter: { ... } } })→ 会报unknown operator: $filter - 正确写法：
db.collection.aggregate([ { $project: { items: { $filter: { input: "$items", cond: { $gt: ["$$this.price", 100] } } } } } ]) - 注意
$$this是默认变量名，也可显式写as: "item"，然后用$$item.price
$filter 的 input 字段必须是数组，否则报错
如果字段不存在、为 null，或值是字符串/数字等非数组类型，$filter 会直接中断整个 pipeline 并抛出错误（不是静默跳过）。
- 安全做法：先用
$ifNull或$cond做兜底，例如input: { $ifNull: ["$items", []] } - 调试时可加
$type检查：{ $type: "$items" }，确认返回"array" - MongoDB 6.0+ 支持
limit参数，如需只取前 3 个匹配项：limit: 3
性能与兼容性要注意的点
$filter 本身不走索引，它是在内存中对已加载的数组做遍历；所以真正影响性能的是「多少文档被拉进 pipeline」，而不是 $filter 多慢。
- 务必在
$match阶段先缩小文档集，比如{ "items.price": { "$gt": 100 } }能命中索引 -
$filter在 MongoDB Community 4.2+、Atlas 所有版本、Enterprise 4.0+ 均可用，无需升级到最新版 - 不要在
$filter的cond里调用函数（如$regex）处理大量文本，这会显著拖慢响应
真正容易被忽略的是：你写的 $filter 表达式，其作用域仅限于当前数组字段——它没法访问同级其他字段，更没法跨文档引用。如果业务需要「根据父文档状态动态决定子数组筛选条件」，就得换用 $map + $cond 组合，或者提前把逻辑下沉到应用层。
