用途：为在 MongoDB 上使用 Mongoose 的开发者提供现代规范，重点覆盖 Mongoose 8.x/9.x、严格 TypeScript 集成与 2025 生态下的性能优化。
主要能力与要点：TypeScript 优先，Mongoose 8+ 自带类型推断，@types/mongoose 已废弃；性能方面 Mongoose 9 引入架构调整以降低开销，原生向量搜索支持成为 AI 功能标配；完整支持 async/await 迭代器与原生 Promise。
TypeScript 集成：不要继承 Document，改用普通 interface，由 Mongoose 推断其余类型。用 Schema<IUser> 和 model<IUser> 定义模型，避免在接口上 extends Document，让 HydratedDocument 类型自动处理。ObjectId 使用 Types.ObjectId 具体类型。
性能优化：只读操作（如 GET 请求）始终使用 .lean()，跳过 hydration，查询速度提升 30-50%；在 Schema 中为常见查询模式定义复合索引，如 userSchema.index({ organization: 1, email: 1 })；使用投影只取所需字段，网络 I/O 常是瓶颈，如 User.find({}, { name: 1 }).lean()。
连接管理：在无服务器/边缘环境（Vercel、Next.js、Remix）使用带缓存的单例模式，防止连接耗尽；通过 global 缓存连接，开发热重载时复用，connect 选项可设 bufferCommands: false。
适用场景：MongoDB 数据建模、类型安全的 Node.js/TypeScript 服务端开发、Serverless API 路由、AI 相关向量检索。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；Mongoose 9 架构调整细节与向量搜索具体用法暂未提供。