$addFields 是 MongoDB 聚合中安全增量添加字段的专用操作符，保留原有字段、支持表达式计算，而 $set 因隐式丢弃未声明字段易致数据截断；引用字段须用 $xxx 形式，嵌套用点号，数组需 $unwind 才能逐元素处理。
$addFields 是 MongoDB 聚合管道中真正“即插即用”的字段生成工具，不是装饰，也不改原始文档结构——它只在当前 pipeline 阶段之后注入新字段，后续阶段就能直接引用。
为什么不能用 $set 替代 $addFields？
表面上看 $set 也能加字段，但本质不同：$set 是 $project 的语法糖，会隐式丢弃未显式声明的字段；而 $addFields 默认保留所有原有字段，只叠加新增内容。一旦你漏写某个旧字段进 $set，它就没了。
- 使用
$addFields：安全、语义明确、适合增量计算 - 误用
$set做多字段扩展：容易意外截断数据，尤其在 pipeline 中间阶段 - 注意：MongoDB 4.2+ 才支持在
$set中使用聚合表达式（和$addFields表达能力一致），但语义风险仍在
$addFields 中怎么引用已有字段做计算？
所有字段引用必须用 $字段名 形式，且区分大小写。嵌套字段用点号（$user.profile.age），数组字段可用 $array.0 或聚合操作符（如 $arrayElemAt）提取。
- 错误写法：
"fullName": " $firstName + ' ' + $lastName "（字符串拼接不能直接写 JS 式表达式） - 正确写法：
"fullName": { "$concat": ["$firstName", " ", "$lastName"] } - 时间计算示例：
"ageInDays": { "$divide": [{ "$subtract": ["$$NOW", "$createdAt"] }, 86400000] }（注意毫秒转天） - 空值处理建议包裹
$ifNull，否则整个表达式可能返回null或报错
常见报错：Unrecognized expression '$xxx' 怎么排查？
这个错误几乎都源于表达式写法不合法——不是字段不存在，而是 MongoDB 不认识你写的那个操作符或语法结构。
- 检查是否拼错操作符名，比如把
$multiply写成$mult - 确认操作符参数个数对得上，例如
$cond必须是三元对象形式：{ if: ..., then: ..., else: ... }，不能写成数组 - 嵌套过深时，优先拆成多个
$addFields阶段，比塞在一个里更易读、易调试 - 聚合表达式里不能直接访问变量（如 JS 的
let），所有“变量”必须来自文档字段（$xxx）或系统变量（$$NOW,$$ROOT）
最常被忽略的是：当计算结果依赖数组字段时，$addFields 不会自动展开数组——如果你希望为每个数组元素生成一个新字段，得先 $unwind，而不是指望 $addFields “聪明地广播”。这点在处理标签、权限列表、历史记录等场景下特别容易栽跟头。
