MongoDB的文档结构灵活，一条文档动辄几十个字段，而实际业务中很多查询只需要其中两三个字段。如果不做任何处理，驱动程序会把完整文档从服务端传输到客户端，网络开销、序列化开销和内存占用都会随之增加。projection投影机制允许我们在查询时明确声明需要的字段，数据库只返回这些内容，是从源头减少数据传输量的最直接手段。
projection的基本语法：包含与排除两种模式
projection出现在find方法的第二个参数位置，语法上是一个对象，键是字段名，值是1或true表示包含，0或false表示排除。假设有一个用户集合users，每条文档包含姓名、年龄、邮箱、地址等字段，只想取出姓名和年龄时可以这样写：
db.users.find(
{ status: "active" },
{ name: 1, age: 1 }
)
返回结果中每个文档只包含name、age和_id三个字段。这里要注意_id是一个特例：只要不做任何声明，它默认会被返回。如果不需要_id，必须显式地用{ _id: 0 }把它排除掉。
投影有两条铁律需要记住。第一，除了_id之外，包含和排除不能混用在同一条语句里，比如{ name: 1, age: 0 }会直接报错，因为数据库无法判断你对其他未声明字段的意图。第二，排除模式适合字段较少、想剔除个别敏感字段的场景，包含模式适合字段较多、只取少数字段的场景，两者按文档结构特点选择即可。
// 排除模式：返回除password之外的所有字段
db.users.find(
{ status: "active" },
{ password: 0, salt: 0 }
)
嵌套文档与数组字段的投影技巧
实际项目中的文档往往有多层嵌套结构，projection同样支持深入到嵌套文档内部取值。使用点号路径即可精确到子字段，例如用户文档里有一个address嵌套对象，只需要返回其中的城市信息：
db.users.find(
{},
{ name: 1, "address.city": 1 }
)
返回的文档中address对象只会包含city一个键，其他子字段全部被裁剪掉。这种写法在日志分析、报表统计类场景中非常实用，可以避免把深层嵌套的大对象整个搬回来。
数组字段的投影有几个进阶用法。最简单的是用点号直接投影数组内的子字段，例如"orders.amount"会返回orders数组中每个元素的amount值。如果想限制数组返回的元素数量，可以配合$slice操作符：
// 只返回comments数组的前5条评论
db.posts.find(
{ _id: postId },
{ title: 1, comments: { $slice: 5 } }
)
// 跳过前10条，取之后的5条
db.posts.find(
{ _id: postId },
{ comments: { $slice: [10, 5] } }
)
还有一种特殊的投影操作符$elemMatch，它可以只返回数组中第一个满足条件的元素。比如一篇帖子有几百条评论，你只想看某个用户的那条评论，用它就能精准取出，而不是把整个数组拉回客户端再过滤。
聚合管道中的project阶段
除了find查询，聚合框架里的$project阶段提供了更强大的字段控制能力，不仅能包含和排除字段，还能重命名字段、计算派生字段。基本用法和find投影类似：
db.orders.aggregate([
{
$project: {
orderId: 1,
total: 1,
// 重命名：把user.name输出为customerName
customerName: "$user.name",
// 派生字段：单价乘以数量
amount: { $multiply: ["$price", "$quantity"] }
}
}
])
在聚合管道中建议把$project尽量放在管道靠前的位置（在$match之后），这样后续阶段处理的数据量会明显减少，整个管道的执行效率更高。这一点在文档数量大、字段多的集合上效果尤其明显。
需要注意，从MongoDB 4.4开始$project支持嵌套文档的输出写法，可以直接构造嵌套结构，还能配合$cond、$ifNull等表达式对字段做条件处理，灵活性远超find投影。但也要避免在投影阶段做过重的计算，复杂逻辑应该交给$addFields或应用层处理。
使用projection的注意事项与性能建议
第一，投影要和索引配合才能发挥最大效果。如果查询字段和投影字段都能被一个覆盖索引命中，MongoDB可以直接从索引返回结果，完全不用回表读取文档，性能提升非常可观。可以用explain查看执行计划，如果显示IXSCAN且totalDocsExamined为0，说明查询被索引覆盖了。
第二，投影虽然减少了网络传输，但服务端读取文档的工作并不会因此减少，除非命中覆盖索引。所以投影是传输层优化，索引才是读取层优化，两者搭配使用才完整。另外排除模式（值设为0）无法利用覆盖索引，因为它需要读取完整文档才知道要排除哪些字段，这一点在性能敏感的查询中要特别留意。
第三，各语言驱动对投影的写法略有差异。以Node.js驱动为例，投影对象作为options参数传入：
const result = await db.collection('users').find(
{ status: 'active' },
{ projection: { name: 1, age: 1, _id: 0 } }
).toArray();
最后提醒一点，不要在投影里写入敏感字段依赖它做安全防护，投影只是查询层的裁剪，正确做法是在应用层或通过视图、字段级权限控制来隔离敏感数据。把projection用对位置，配合合理的索引设计，大多数列表页查询的响应时间和带宽占用都能显著下降。
MongoDB projection投影查询字段过滤修改时间：2026-09-03 14:17:06