$rename是MongoDB唯一支持字段重命名的操作符，必须配合updateMany()或update()使用，不支持$set替代；空filter{}匹配全部文档，支持单/多字段及嵌套字段（点号语法）重命名，但存在覆盖同名字段、不支持数组通配、不保留字段顺序等限制。
$rename 是唯一能直接重命名字段的操作符，必须用 updateMany() 或 update() 配合它，不能靠 $set 或 save 替代。
用 updateMany() 批量重命名单个或多个字段
这是最常用、最安全的方式。空查询条件 {} 表示匹配全部文档；$rename 接一个对象，键是旧字段名，值是新字段名。
- 单字段：
db.users.updateMany({}, { $rename: { "firstName": "first_name" } }) - 多字段：
db.users.updateMany({}, { $rename: { "firstName": "first_name", "lastName": "last_name", "phone": "mobile" } }) - 嵌套字段（点号语法）：
db.users.updateMany({}, { $rename: { "address.zipCode": "address.postalCode" } })
注意：MongoDB 5.0+ 支持空 $rename 操作（如 { $rename: {} }），不会报错，但也不起作用 —— 别误以为这是“无害占位”，它只是被忽略。
别用 update() 默认行为，小心只改第一条
老写法 db.users.update({}, { $rename: { ... } }) 在不加参数时默认只更新第一个匹配文档，极易漏数据。
- 加
{ multi: true }可修复：db.users.update({}, { $rename: { "old": "new" } }, { multi: true }) - 但
update()已在 mongosh 中标记为 deprecated，官方推荐直接用updateMany() - 如果脚本里混用了
update()和updateMany()，要注意前者在 6.0+ 版本中可能被移除
重命名时的几个硬限制和易踩坑点
$rename 看似简单，但实际执行时有几个不可绕过的约束：
- 目标字段名（新名称）若已存在，原字段值会直接覆盖它 —— 不会合并、不报错、不警告
- 不能跨数组索引重命名，比如
"comments.0.text"→"comments.0.content"是合法的，但"comments.text"（想批量改所有 comments 里的 text）会失败 - 字段顺序不保留：重命名后，新字段会按字典序插入到文档末尾，原有位置信息丢失（对某些依赖字段顺序的旧应用可能是隐性 break）
- 原子性仅限单文档：一次
updateMany()调用不是事务级原子操作，中间失败会导致部分文档完成重命名、部分未动
真正麻烦的不是语法，而是重命名后字段引用是否全局同步 —— 应用代码、聚合管道、索引定义、校验规则（validation schema）、甚至前端表单绑定，都得手动检查一遍。漏掉一个 firstName 的引用，就可能让某条用户数据永远卡在旧字段里。
