$操作符不生效是因为查询条件未显式包含目标数组字段，必须在filter中声明如{"tags":"old"}或{"tags":{$exists:true}}，否则$无法定位作用域而静默失败。
直接用 $ 位置操作符就能更新数组中第一个匹配的元素，但必须满足查询条件里已包含该数组字段，且不能用于 upsert 或嵌套多层数组场景。
为什么 $ 操作符有时不生效？
常见原因是查询条件没“显式触达”目标数组字段。MongoDB 要求 $ 的使用前提：查询 filter 中必须出现被更新的数组字段（哪怕只是 { "tags": { $exists: true } }），否则 $ 找不到作用域，静默失败。
- 错误写法：
db.posts.updateOne({ _id: ObjectId("...") }, { $set: { "tags.$": "new" } })—— 查询没提tags，$不起作用 - 正确写法：
db.posts.updateOne({ _id: ObjectId("..."), "tags": "old" }, { $set: { "tags.$": "new" } })——"tags": "old"让$锁定第一个值为"old"的元素 - 若数组元素是对象，需用
$elemMatch精确匹配字段：{ "comments": { $elemMatch: { "author": "alice", "status": "draft" } } }
$[<identifier>]</identifier> 和 $[] 怎么选？
$[] 是全量更新整个数组所有元素，$[<identifier>]</identifier> 是带条件筛选后更新——两者都必须配合 arrayFilters 选项，且只在 updateMany、findAndModify 等支持该选项的方法中可用。
- 更新所有数组元素（无条件）：
{ $set: { "scores.$[]": 100 } } - 只更新分数大于 80 的元素：
{ $set: { "scores.$[s]": 95 } }+{ arrayFilters: [ { "s": { $gt: 80 } } ] } -
<identifier></identifier>必须小写字母开头、只含字母数字，不能是$或保留字 -
arrayFilters里不能用$expr、$text、$where
更新时容易把数组搞成 null？
用 $unset 配合 $ 时，不是删除数组元素，而是把它设为 null。真正移除元素得用 $pull。
-
{ $unset: { "items.$.name": "" } }→ 把匹配元素的name字段置为null，items数组长度不变 -
{ $pull: { items: { name: "toRemove" } } }→ 从items数组中删掉整个匹配对象 - 如果想用条件删元素但又怕误删，先加
multi: false测试，确认匹配逻辑再放开
真正难的不是语法，而是 query 条件和 arrayFilters 的耦合关系——一个字段漏写、一个 identifier 大小写错、或者 arrayFilters 里用了不支持的操作符，都会让更新静默跳过，连 warning 都没有。动手前建议先用 find() 验证查询是否真能命中目标文档和数组元素。
