find 查询和投影如何工作？

Question

find 查询和投影如何工作？

Accepted Answer

**`find`** 方法检索与筛选器匹配的文档；**projection** 控制返回哪些字段。它们一起让你查询正确的文档并塑造输出形式——这是高效读取数据的基础。

## find — 查询文档

```js
db.users.find();                          // all documents
db.users.find({ age: { $gt: 25 } });      // filter: matching documents (a CURSOR)
db.users.findOne({ email: "ann@x.com" }); // the FIRST matching document (or null)

// find returns a CURSOR you can chain methods on
db.users.find({ active: true })
  .sort({ name: 1 })                      // sort
  .limit(10)                              // limit
  .skip(20);                              // skip (pagination)
```

`find` 返回一个 **cursor**（指向结果的指针），你可以与 `sort`、`limit`、`skip` 等链式调用。`findOne` 直接返回单个文档。

## Projection — 选择返回哪些字段

```js
// projection: 1 = include, 0 = exclude
db.users.find({ active: true }, { name: 1, email: 1 });        // only name and email (+ _id)
db.users.find({}, { password: 0 });                           // everything EXCEPT password
db.users.find({}, { name: 1, _id: 0 });                       // name only, exclude _id
```

**Projection**（第二个参数）控制返回的字段：`1` 包含，`0` 排除。`_id` 默认被包含（用 `_id: 0` 排除）。通常你不能混合包含和排除（除了 `_id`）。

## 为什么投影很重要：效率和安全性

```text
✓ EFFICIENCY — return only needed fields → less data transferred (especially for large
  documents or large result sets) → faster
✓ SECURITY — EXCLUDE sensitive fields (passwords, internal data) so they don't leak
  → e.g. always project out password fields when returning user data
```

## 投影嵌套和数组字段

```js
db.users.find({}, { "address.city": 1 });        // nested field (dot notation)
db.posts.find({}, { comments: { $slice: 5 } });   // first 5 array elements
```

## 为什么这很重要

`find` 和 projection 是 MongoDB 中**读取数据**的基础——查询正确的文档并塑造输出形式是持续的需求，因此理解它们是日常必备知识。

了解 `find` 如何工作（返回匹配文档的 cursor，可与 `sort`/`limit`/`skip` 链式调用进行排序和分页）和 `findOne`（单个文档）是读取数据的基础。**Projection** 由于两个实际原因特别重要：**效率**（仅返回你需要的字段可以减少传输的数据——对于大型文档或结果集来说很重要，提高性能）以及特别是**安全性**（排除密码或内部数据等敏感字段，使其不会在查询结果中泄露——一个常见且重要的实践，例如在返回用户数据时始终排除密码字段，类似于在 API 中使用响应模型）。

理解如何包含（`1`）或排除（`0`）字段、`_id` 默认被包含，以及如何投影嵌套/数组字段涵盖了查询结果的实际塑造。

由于读取数据是最常见的数据库操作，并且由于带有 projection 的 `find` 是你高效且安全地检索具有正确字段的正确文档的方式，理解 find 查询和 projection——cursor 模型、用于排序/分页的链式调用，以及特别是用于效率和安全性的 projection（排除敏感数据）——是任何数据读取代码都需要掌握的必要的、频繁使用的 MongoDB 知识，其中排除敏感字段的安全性方面是一个特别重要的实际考虑。