如何在couchdb-nano中使用find()方法按自定义type属性过滤文档

我懂你的需求——因为CouchDB没有集合的概念，所以你给实体加了自定义的type属性，想要用nano的find()方法过滤出特定type的文档（比如所有type为User的用户）。接下来我一步步给你讲怎么正确实现：

1. 先确认nano版本支持Mango查询 #

首先要保证你用的nano版本是支持Mango查询的，一般nano@9.x及以上的版本都已经实现了find()方法，如果你的版本太老，建议先升级。

2. 编写完整的查询代码 #

结合你的UserModel，这里给你一个可直接复用的示例：

import nano from 'nano';

// 定义你的用户实体模型
class UserModel {
  type: string = 'User';
  name: string = '';
  mail: string = '';
}

// 连接到你的CouchDB实例，替换成自己的地址和数据库名
const couchDb = nano('http://localhost:5984');
const db = couchDb.db.use('your_database_name') as nano.DocumentScope<UserModel>;

// 封装查询所有用户的异步函数
async function getAllUsers() {
  try {
    // 调用find()方法，传入Mango查询参数
    const queryResult = await db.find({
      // 核心：用selector匹配type为User的文档
      selector: { type: 'User' },
      // 可选：指定要返回的字段，减少不必要的数据传输
      fields: ['_id', '_rev', 'name', 'mail'],
      // 可选：按name字段升序排序
      sort: [{ name: 'asc' }],
      // 可选：分页参数
      limit: 10,
      skip: 0
    });

    console.log('查询到的用户列表:', queryResult.docs);
    return queryResult.docs;
  } catch (error) {
    console.error('查询失败:', error);
    throw error;
  }
}

// 执行查询
getAllUsers();

3. 关键提示：一定要创建持久索引 #

第一次执行查询时，CouchDB会自动生成临时索引，但临时索引的性能极差，生产环境必须手动创建持久索引：

async function createTypeIndex() {
  try {
    await db.createIndex({
      index: {
        fields: ['type'] // 基于type字段创建索引
      },
      name: 'type-specific-index', // 索引名称
      ddoc: 'type-index-design-doc' // 关联的设计文档ID，方便后续管理
    });
    console.log('type字段的持久索引创建完成');
  } catch (error) {
    console.error('索引创建失败:', error);
  }
}

// 建议先创建索引，再执行查询
createTypeIndex().then(getAllUsers);

4. TypeScript类型处理优化 #

你之前用了<nano.DocumentScope&...的写法，其实更规范的是把UserModel作为泛型传给DocumentScope，就像示例里的as nano.DocumentScope<UserModel>，这样TypeScript就能自动推断queryResult.docs的类型是UserModel[]，避免类型报错。

内容的提问来源于stack exchange，提问作者Daniel