$addFields 和 $set 在 MongoDB 4.2+ 中完全等价，是同一聚合阶段的两个名称，语法、行为（包括覆盖同名字段、支持点号路径、嵌套结构）完全一致；官方保留二者只为语义统一——$set 对齐更新操作语义，$addFields 延续聚合历史命名。
$addFields 和 $set 在 MongoDB 4.2+ 中完全等价，没有行为区别。它们是同一聚合阶段的两个名字，不是“类似功能”，而是“同一个东西”。
为什么官方同时保留 $addFields 和 $set？
纯粹为了语义统一和操作一致性：
- $set 出现在
updateOne、updateMany等写操作中，用户早已熟悉它的“设置字段值”含义 - $addFields 是聚合管道里更早引入的阶段名，强调“添加”动作
- 从 4.2 开始，MongoDB 把 $addFields 的别名设为 $set，让聚合管道和更新操作的语义对齐
- 两者在聚合中接受完全相同的语法、支持嵌套、点符号、覆盖同名字段等所有行为
$set / $addFields 在聚合中如何实际使用？
无论用哪个，都只是往文档里加或改字段，不删字段、不重排字段顺序、不改变原始字段结构：
- 写法上：
{$set: {total: {$sum: "$scores"}}}和{$addFields: {total: {$sum: "$scores"}}}效果一模一样 - 能覆盖已有字段（包括
_id），比如{$set: {_id: "$studentId"}}会替换原_id - 支持点号路径：如
{$set: {"address.city": "Beijing"}}，目标字段不存在时自动创建嵌套结构 - 多个字段一次写：只用一个
$set阶段，别拆成多个——性能无差别，但可读性更好
容易踩的坑：别混淆 $set 和 update 中的 $set
聚合里的 $set 是阶段操作符，只影响当前 pipeline 流程中的文档；它不会修改数据库里的原始数据。而 db.collection.updateOne({},{ $set: {...} }) 才真改数据。很多人看到聚合里用了 $set，误以为是在更新集合，其实只是临时投影。
另一个常见混淆点：有人以为 $set 只能设新字段，$addFields 才能覆盖旧字段——错。两者都覆盖，只要字段名重复就覆盖，这是设计行为，不是 bug。
真正要注意的是字段名冲突和嵌套路径拼写错误，而不是纠结该用哪个关键字。选 $set 还是 $addFields，取决于你团队的命名习惯或代码风格统一要求——底层没区别，MongoDB 引擎处理逻辑完全一致。
