必须用 deleteOne() 而不是 deleteMany() 的情况是当明确只需删除一条且条件唯一时，如按 _id 删除或业务要求“最多删一条”；误用 deleteMany() 可能批量误删，且 deleteOne() 返回 deletedCount 为 0 或 1，便于验证结果。
直接用 deleteOne()，传一个精确匹配的查询条件就行。它只删第一个匹配项，不会误删其他文档。
什么时候必须用 deleteOne() 而不是 deleteMany()
当你明确只想删一条、且确保条件唯一时——比如按 _id 删除，或业务上要求“最多删一条”。deleteMany() 一旦条件写宽了（比如只写了 { status: "pending" }），可能批量删掉几十条，而你本意只是清理某次测试数据。
- 常见错误：把
deleteOne({ email: "user@example.com" })写成deleteMany({ email: "user@example.com" })，结果删掉所有同名邮箱（哪怕数据库里真有重复） - 更隐蔽的问题：没加索引的字段做条件（如
name），deleteOne()仍会全表扫描，但至少只删一条；而deleteMany()会扫完整个集合再删 - 注意：
deleteOne()返回的DeleteResult中deletedCount只能是0或1，这是验证是否成功的关键依据
deleteOne() 的典型用法和参数陷阱
最常用形式就是 db.collection.deleteOne({ _id: ObjectId("...") })，但实际中容易忽略三点：
-
_id值必须是ObjectId类型，不能直接写字符串——deleteOne({ _id: "5f21489c0cf8d519bcb89573" })不生效，得用ObjectId("5f21489c0cf8d519bcb89573") - 如果用复合条件（如
{ userId: 123, type: "temp" }），要确认这两个字段在业务逻辑中是否真能唯一确定一条记录；否则删掉哪一条不可控 - 不支持
hint参数（不像find()），所以没法强制走某个索引——想优化性能，得提前在查询字段上建好索引
别用 remove() ——它已被弃用
MongoDB 从 3.2 版本起就标记 remove() 为废弃，4.4+ 完全移除。现在执行 db.collection.remove({ _id: ... }) 会报错或静默失败，取决于驱动版本。
- 旧脚本里看到
remove({ ..., justOne: true })，一律替换成deleteOne(...) -
remove()的justOne参数语义模糊（true/false 默认行为不一致），deleteOne()名称即意图，无歧义 - 部分老教程还教用
remove({})清空集合，这其实是危险操作——它等价于deleteMany({})，但名称毫无警示性
真正难的不是调哪个函数，而是删之前有没有确认条件足够窄、有没有备份、有没有在测试环境跑过。线上删文档，永远先 find() 查一遍再删。
