$project重命名字段需显式声明新名并设旧字段为0，计算字段必须用聚合表达式如$multiply，路径引用须加$且用点号分隔，执行顺序影响性能。
用 $project 重命名字段时不能直接赋值，必须用新字段名映射旧字段
很多人写成 { "newName": "$oldName" } 就以为重命名成功了，其实这只会新增字段，原字段还在。MongoDB 的 $project 不是“改名指令”，而是“投影规则声明”——它决定最终输出哪些字段、值是什么。
真正重命名，得靠显式声明新字段并指向旧字段路径，同时把原字段设为 0（或不出现）来排除：
{
"_id": 0,
"fullName": "$name",
"ageInMonths": { "$multiply": ["$age", 12] }
}- 字段名（如
fullName）是你要的新名字，右边的"$name"是表达式，不是字符串 - 如果还想保留原始
name字段，就别加"name": 0；想彻底替换，就得明确排除它 -
_id默认会输出，不想要就得显式写"_id": 0
$project 中计算字段必须用聚合表达式，不能用 JS 函数或字面量运算
写 "total": "$price * $tax" 会报错：invalid operator '$price'。MongoDB 聚合管道里所有字段引用和计算都必须走标准表达式语法，比如 $multiply、$add、$cond 等。
常见计算场景对应写法：
{
"discountedPrice": { "$subtract": ["$price", "$discount"] },
"isExpensive": { "$gt": ["$price", 1000] },
"category": {
"$switch": {
"branches": [
{ "case": { "$eq": ["$type", "book"] }, "then": "literature" },
{ "case": { "$eq": ["$type", "movie"] }, "then": "media" }
],
"default": "other"
}
}
}- 所有操作符必须是大驼峰（
$multiply），不能小写或下划线 - 数组参数顺序有约定：比如
$subtract是[被减数, 减数]，反了结果就错 - 字符串字面量要用双引号包裹，且不能直接拼接，比如
"$firstName + ' ' + $lastName"是非法的——得用$concat
嵌套字段重命名或计算时，路径写法容易漏掉 $ 或多加点
比如文档里有 {"user": {"profile": {"email": "a@b.com"}}}，想把 user.profile.email 提到顶层叫 contactEmail，错误写法是 "contactEmail": "user.profile.email"（缺 $）或 "contactEmail": "$user.profile.email"（对，这个才对）。
注意点：
- 路径前必须加
$，否则 MongoDB 当作字面字符串处理 - 嵌套层级用点号分隔，不能用方括号（
$user["profile"]["email"]不合法） - 如果字段名含点号或美元符（极少见），得用
$getField配合字符串路径，但绝大多数情况不用 - 计算嵌套字段时同样要带
$，例如{ "$add": ["$stats.views", "$stats.shares"] }
性能提示：过度使用 $project 可能拖慢聚合，尤其在早期阶段
如果在 $match 之前就用 $project 计算一堆字段，MongoDB 得对每条文档都执行这些表达式，哪怕后续 $match 会筛掉大部分数据。顺序很重要。
- 优先让
$match和$sort尽早缩小数据集 - 避免在
$project中做复杂逻辑（比如嵌套$map+$filter）除非必要 - 如果只是想排除几个字段，用
$project: { fieldToDrop: 0 }比全字段显式列出更轻量 - 用
explain("executionStats")查看实际文档处理量，确认$project是否成了瓶颈
字段重命名看着简单，但路径、表达式、执行顺序三处稍不留神，结果就和预期差很远。尤其当 pipeline 里有多个 $project 时，后一个看到的字段名已经是前一个重命名后的了——这点最容易被忽略。
