#📚 API 参考索引

#📚 核心概念

| transaction-optimizations.md | 事务优化策略 | | distributed-deployment.md | 分布式部署指南（多实例缓存一致性）⭐ | | events.md | 事件系统 |

---

#🔍 查询操作（Query Operations）

---

#✏️ 写入操作（Write Operations）

#插入操作

#更新操作

#便利方法（Convenience Methods）

#删除操作

---

#📊 聚合操作（Aggregation Operations）

---

#🔗 高级功能

---

#🛠️ 工具与配置

---

#🔧 兼容性与测试

| esm-support.md | ES Module (import) 支持 ✨ |

---

#📖 按功能分类

#CRUD 操作

Create (创建):

• insert-one.md - insertOne（插入单个文档）
• insert-many.md - insertMany（批量插入，10-50x 性能提升）
• insertBatch.md - insertBatch（超大批量插入）
• write-operations.md - 插入操作完整指南

Read (读取):

• find.md - find
• findOne.md - findOne
• findPage.md - findPage
• count.md - count
• distinct.md - distinct

Update (更新):

• update-operations.md - 更新操作完整指南
• update-one.md - updateOne
• update-many.md - updateMany
• replace-one.md - replaceOne
• find-one-and-update.md - findOneAndUpdate
• find-one-and-replace.md - findOneAndReplace

Delete (删除):

• delete-one.md - deleteOne（删除单个文档）
• delete-many.md - deleteMany（批量删除）
• find-one-and-delete.md - findOneAndDelete（原子删除并返回）

#高级查询

• aggregate.md - 聚合管道
• explain.md - 查询计划
• chaining-api.md - 链式调用

#性能与缓存

• cache.md - 缓存系统
• bookmarks.md - 分页优化

---

#🚀 快速开始路径

新用户推荐阅读顺序:

1. connection.md - 了解如何连接数据库
2. find.md - 学习基础查询
3. insert-one.md / insert-many.md - 学习插入数据
4. update-one.md / update-many.md - 学习更新数据
5. delete-one.md / delete-many.md - 学习删除数据
6. cache.md - 了解缓存机制
7. transaction.md - 学习事务管理
8. distributed-deployment.md - 多实例部署（生产环境必读）

---

文档总数: 85个
最后更新: 2025-01-06 新增:

• ✨ esm-support.md - ES Module (import) 支持
• ✨ findOneAnd-return-value-unified.md - 返回值统一说明