如何通过ContactsContract单次查询匹配姓名/电话/邮箱的联系人？

当然可以实现！你完全不需要拆分多次查询，ContactsContract的设计已经帮我们封装了表间关联逻辑，直接构建单次查询就能满足需求，还能轻松按显示名称排序。

核心思路 #

Contacts、RawContacts和Data之间的关联关系，ContactsContract体系已经内置处理了，不用手动写Data.RAW_CONTACT_ID = RawContacts.ID这类连接条件。我们可以直接以ContactsContract.Data.CONTENT_URI作为查询入口（这是所有联系人数据的统一访问点），通过筛选MIMETYPE区分电话、邮箱数据，同时匹配显示名称。

具体实现代码示例 #

首先要确保已获取READ_CONTACTS权限（Android 6.0及以上需动态申请），然后构建查询参数：

String searchKeyword = "你的搜索关键词";

// 定义需要返回的字段（投影）
String[] projection = {
    ContactsContract.Contacts._ID,
    ContactsContract.Contacts.DISPLAY_NAME_PRIMARY,
    // 若需要获取匹配的具体电话/邮箱，可添加对应字段
    ContactsContract.CommonDataKinds.Phone.NUMBER,
    ContactsContract.CommonDataKinds.Email.ADDRESS
};

// 构建WHERE筛选条件，对应你需求的逻辑
String selection = "(" + ContactsContract.Contacts.DISPLAY_NAME_PRIMARY + " LIKE ?) OR " +
        "((" + ContactsContract.Data.MIMETYPE + " = ?) AND (" + ContactsContract.CommonDataKinds.Phone.NUMBER + " LIKE ?)) OR " +
        "((" + ContactsContract.Data.MIMETYPE + " = ?) AND (" + ContactsContract.CommonDataKinds.Email.ADDRESS + " LIKE ?))";

// 对应筛选条件的参数值
String[] selectionArgs = {
    "%" + searchKeyword + "%",
    ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE,
    "%" + searchKeyword + "%",
    ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE,
    "%" + searchKeyword + "%"
};

// 排序规则：按显示名称升序排列
String sortOrder = ContactsContract.Contacts.DISPLAY_NAME_PRIMARY + " ASC";

// 执行查询
ContentResolver contentResolver = getContentResolver();
Cursor cursor = contentResolver.query(
    ContactsContract.Data.CONTENT_URI,
    projection,
    selection,
    selectionArgs,
    sortOrder
);

注意事项 #

• 去重处理：一个联系人可能有多个电话/邮箱，查询后会返回多条同一联系人的记录。如果只需要每个联系人的唯一记录，可以在投影中加入DISTINCT（比如把投影数组第一个元素改为"DISTINCT " + ContactsContract.Contacts._ID"），或者在筛选条件后追加" GROUP BY " + ContactsContract.Contacts._ID。
• 权限要求：必须在Manifest中声明<uses-permission android:name="android.permission.READ_CONTACTS" />，Android 6.0+版本还需动态申请该权限才能正常执行查询。
• 性能提示：LIKE语句开头的%会触发全表扫描，若对性能要求较高，可考虑使用ContactsContract的搜索建议接口，或在本地数据库中建立自定义索引优化搜索速度。

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