# 更新文档（updateOne、updateMany、replaceOne）

URL: https://caijiao.org/mongodb/02-basics/06-update
Source: docs/mongodb/02-basics/06-update.md
Description: 本章节介绍 MongoDB 中更新文档的主要方法，包括 'updateOne'、'updateMany' 和 'replaceOne'，帮助用户灵活修改数据。

[MongoDB](/mongodb/) 提供多种更新操作，允许修改集合中的文档内容。常用的方法有 `updateOne`、`updateMany` 和 `replaceOne`。

## updateOne()

`updateOne()` 用于更新符合条件的第一条文档。可以使用更新操作符（如 `$set`、`$inc`）修改指定字段。

示例：将名字为 "Alice" 的文档的年龄更新为 30：

```js
db.users.updateOne(
  { name: "Alice" },
  { $set: { age: 30 } }
)
````

## updateMany()

`updateMany()` 用于更新所有符合条件的文档，批量修改多个文档。

示例：将所有年龄小于 25 的用户的状态字段设置为 "inactive"：

```js
db.users.updateMany(
  { age: { $lt: 25 } },
  { $set: { status: "inactive" } }
)
```

## replaceOne()

`replaceOne()` 用于用一个新的文档完全替换符合条件的第一条文档，替换时需要提供完整文档。

示例：将名字为 "Bob" 的文档完全替换为新的内容：

```js
db.users.replaceOne(
  { name: "Bob" },
  { name: "Robert", age: 40, email: "robert@example.com" }
)
```

---

合理使用更新方法和操作符，可以灵活地对数据进行局部修改或整体替换，满足不同业务需求。