deleteOne()（删除单条文档）
最后更新：2026-10-09
deleteOne()（删除单条文档）
deleteOne()删除集合中第一条匹配过滤条件的文档，多条匹配时只删自然顺序的第一条。返回结果包含deletedCount，表示实际删除的文档数（0或1）。删除操作不可撤销，建议先用`db.users.findOne({ name: 'Alice' })`确认目标。它是清理单条数据最直接的方式。
| 分类 | 写入 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
db.<集合>.deleteOne(<过滤条件>, { writeConcern: <选项> })⚙️ 参数
| 过滤条件 | 匹配要删除文档的条件对象。 |
|---|---|
| writeConcern | 可选。写入关注级别。 |
返回值：DeleteResult对象：{ acknowledged, deletedCount }。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// deleteOne：删除名字为Alice的用户
db.users.deleteOne({ name: 'Alice' })运行结果：
{ acknowledged: true, deletedCount: 1 }📌 注意事项
- 只删除第一条匹配文档；要删全部用deleteMany()
- deletedCount为0表示没有匹配文档，不是报错
- 删除不可恢复，生产环境建议先查后删
🏷️ 相关标签
💡 相关案例
📚 相关教程
❓ 常见问题
QdeleteOne会删除所有匹配的文档吗？
A不会，deleteOne()只删除第一条匹配文档。要删除全部匹配文档请用deleteMany()。
QdeleteOne删除不存在的文档会报错吗？
A不会报错，返回deletedCount: 0。可以据此判断过滤条件是否有匹配。
Q删除的文档还能恢复吗？
A不能通过API恢复。删除是物理移除，只能靠备份或oplog（副本集）做有限恢复，重要数据务必先备份。
