如何正确设置CNContact.predicateForContacts筛选含指定内容的邮箱？

嘿，我来帮你搞定这个问题！你遇到的0匹配结果大概率是因为没处理好CNContact中邮箱的多值属性特性，或者漏了关键的字段权限配置。

核心问题解析 #

CNContact的emailAddresses是一个CNLabeledValue<NSString>类型的数组（每个元素对应一个邮箱地址），不是单个字符串属性，所以直接用普通的like语法是行不通的。我们需要针对数组元素的value字段做模糊匹配。

正确的Predicate写法 #

下面是Swift和Objective-C的实现代码，直接就能用：

Swift版本

import Contacts

func findContactsWithEmailContaining(_ substring: String) {
    let contactStore = CNContactStore()
    
    // 1. 请求联系人访问权限（必须先做这一步！）
    contactStore.requestAccess(for: .contacts) { granted, error in
        guard granted, error == nil else {
            print("权限申请失败：\(error?.localizedDescription ?? "未知错误")")
            return
        }
        
        DispatchQueue.main.async {
            do {
                // 2. 构造正确的Predicate：匹配任意邮箱地址包含指定子串（不区分大小写）
                let predicate = NSPredicate(format: "ANY emailAddresses.value CONTAINS[c] %@", substring)
                
                // 3. 必须指定要获取的字段！这里至少要包含邮箱和标识符（删除需要用）
                let keysToFetch: [CNKeyDescriptor] = [
                    CNContactIdentifierKey,
                    CNContactEmailAddressesKey
                ]
                
                // 4. 查询匹配的联系人
                let matchedContacts = try contactStore.unifiedContacts(
                    matching: predicate,
                    keysToFetch: keysToFetch
                )
                
                print("找到 \(matchedContacts.count) 个符合条件的联系人")
                
                // --- 批量删除逻辑示例 ---
                let saveRequest = CNSaveRequest()
                for contact in matchedContacts {
                    let mutableContact = contact.mutableCopy() as! CNMutableContact
                    saveRequest.delete(mutableContact)
                }
                
                try contactStore.execute(saveRequest)
                print("成功删除 \(matchedContacts.count) 个联系人")
                
            } catch {
                print("操作失败：\(error.localizedDescription)")
            }
        }
    }
}

// 调用示例：筛选邮箱含"lbs"的联系人
findContactsWithEmailContaining("lbs")

Objective-C版本

#import <Contacts/Contacts.h>

- (void)findAndDeleteContactsWithEmailContaining:(NSString *)substring {
    CNContactStore *contactStore = [[CNContactStore alloc] init];
    
    // 请求权限
    [contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
        if (!granted || error) {
            NSLog(@"权限申请失败：%@", error.localizedDescription ?: @"未知错误");
            return;
        }
        
        dispatch_async(dispatch_get_main_queue(), ^{
            NSError *fetchError;
            // 构造Predicate
            NSPredicate *predicate = [NSPredicate predicateWithFormat:@"ANY emailAddresses.value CONTAINS[c] %@", substring];
            
            // 指定要获取的字段
            NSArray<id<CNKeyDescriptor>> *keysToFetch = @[
                CNContactIdentifierKey,
                CNContactEmailAddressesKey
            ];
            
            NSArray<CNContact *> *matchedContacts = [contactStore unifiedContactsMatchingPredicate:predicate keysToFetch:keysToFetch error:&fetchError];
            
            if (fetchError) {
                NSLog(@"查询失败：%@", fetchError.localizedDescription);
                return;
            }
            
            NSLog(@"找到 %lu 个符合条件的联系人", (unsigned long)matchedContacts.count);
            
            // 批量删除
            CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
            for (CNContact *contact in matchedContacts) {
                CNMutableContact *mutableContact = [contact mutableCopy];
                [saveRequest deleteContact:mutableContact];
            }
            
            NSError *deleteError;
            BOOL deleteSuccess = [contactStore executeSaveRequest:saveRequest error:&deleteError];
            if (deleteSuccess) {
                NSLog(@"成功删除 %lu 个联系人", (unsigned long)matchedContacts.count);
            } else {
                NSLog(@"删除失败：%@", deleteError.localizedDescription);
            }
        });
    }];
}

// 调用示例
[self findAndDeleteContactsWithEmailContaining:@"lbs"];

关键注意事项（你之前0匹配的可能原因） #

• 必须指定keysToFetch：如果没把CNContactEmailAddressesKey加进去，系统不会加载邮箱字段，你的筛选条件自然找不到匹配项！这是最常见的坑。
• ANY关键字的作用：因为邮箱是数组，ANY表示只要数组中任意一个邮箱符合条件就算匹配。
• CONTAINS[c]的含义：CONTAINS是模糊匹配子串，[c]表示不区分大小写，如果需要严格区分大小写，去掉[c]即可。
• 权限必须提前申请：没有联系人访问权限的话，连读取联系人都做不到，更别说筛选和删除了。

内容的提问来源于stack exchange，提问作者Ralf Bordé