点符号更新嵌套字段必须用 $set 操作符，直接写 {"a.b.c": "val"} 会创建顶层字段而非修改嵌套结构；$unset 才能真正删除字段；数组更新需配合 $、$[] 或 arrayfilters；深层嵌套影响性能与可维护性。
用点符号更新嵌套字段时，$set 是唯一可靠方式
直接写 { "user.profile.name": "Alice" } 作为 update 文档主体是错的——MongoDB 会把它当新字段插入，而不是修改已有嵌套结构。必须显式使用 $set 操作符，否则字段名里的点会被忽略或误解析。
常见错误现象：updateOne({ _id: 1 }, { "user.profile.name": "Alice" }) 执行后，文档里多出一个叫 "user.profile.name" 的顶层字符串字段，而非修改 user → profile → name。
- 永远用
$set: { "user.profile.name": "Alice" }，不要省略操作符 - 如果路径中含数组索引（如
comments.0.text），点符号依然有效，但需确保索引存在，否则静默失败 - 对不存在的中间层级（如
user.profile本身为null或缺失），$set会自动创建对象，无需预检
更新数组内嵌套字段要小心索引越界和匹配精度
想改某个用户的第二条评论内容？不能只靠 comments.1.text 硬编码索引——一旦数组顺序变动或长度不足，就写错位置甚至报错 Path not found。更安全的是结合 $[<i>identifier</i>] 过滤器。
例如：把所有 status: "pending" 的评论文本设为空：
db.posts.updateMany(
{ "comments.status": "pending" },
{ $set: { "comments.$.text": "" } }
)
这里 $ 是位置操作符，只匹配查询条件中第一个满足的元素；若要批量更新所有匹配项，得用 $[] 或带标识符的 $[i]（需 MongoDB 3.6+）。
-
$只影响第一个匹配项，适合“找到即停”场景 -
$[]无条件更新整个数组每个元素，慎用，容易误改 - 带过滤的
$[i]要配合arrayFilters选项，比如{ "i.status": "pending" }
$set 和 $unset 组合才能真正“删除”嵌套字段
有人以为设成 null 或空对象就能删掉嵌套字段，其实只是值变了，字段还占着位置。真删必须用 $unset，且路径写法一样支持点符号。
比如删掉用户头像 URL：
db.users.updateOne(
{ _id: ObjectId("...") },
{ $unset: { "profile.avatarUrl": "" } }
)
注意：$unset 的值任意（习惯写空字符串），MongoDB 只认键名；如果字段根本不存在，操作也静默成功，不会报错。
- 避免用
$set: { "profile.avatarUrl": null }伪装删除——后续$exists查询仍会命中 - 一次
$unset可传多个点路径，如{ "profile.phone": "", "profile.address.zip": "" } - 不能用点符号
$unset数组元素本身（如tags.0），只能删整个数组或用$pull
深层嵌套更新性能差？先确认是否真需要深结构
点符号本身没性能问题，但嵌套过深（比如 a.b.c.d.e.f.g）往往意味着数据模型设计偏关系化。每次更新都得全路径匹配，BSON 解析开销上升，而且难以加有效索引。
真实项目中更容易踩的坑是：为图方便把 JSON 直接塞进字段（如 metadata: { ... }），结果后续所有更新、查询、校验都变脆弱。
- 如果嵌套层级 > 3，优先考虑拆成独立集合 + 引用（
ObjectId） - 高频更新的字段别藏太深，比如用户状态放
status顶层，别塞进settings.preferences.ui.state - 用
explain()看写操作是否命中索引——点符号路径无法被普通复合索引覆盖，除非显式建{"user.profile.name": 1}
