Swift头文件报错：无法找到CNContactPickerDelegate协议声明求助

我前段时间刚踩过这个坑，这种循环导入引发的桥接文件报错确实挺棘手的，尤其是涉及到系统框架的时候。根据我的经验，你可以按照以下步骤逐一排查解决：

• 调整框架导入的位置
  不要在Objective-C的头文件（.h）中直接导入<Contacts/Contacts.h>或<ContactsUI/ContactsUI.h>，而是把这些导入放在对应的.m文件里。如果头文件需要用到相关类型，用@class CNContactPickerViewController; @protocol CNContactPickerDelegate;来前置声明，避免提前引入整个框架导致循环。

• 优化Swift文件的框架导入
  在需要使用Contacts功能的Swift文件顶部单独导入框架：

  import Contacts
  import ContactsUI
  

  不要把这些导入语句放到项目的桥接头文件（ProjectName-Bridging-Header.h）里，否则会导致桥接文件和自动生成的ProjectName-Swift.h互相引用，触发循环导入。

• 确保Swift类的正确暴露
  如果你的Swift类需要被Objective-C调用并作为CNContactPickerDelegate，请确保：

  • 类继承自NSObject（因为Objective-C只能调用继承自NSObject的Swift类）
  • 必要时给类加上@objcMembers标记，或者给需要暴露的代理方法单独加上@objc标记，保证协议方法能被Objective-C识别。比如：

    @objcMembers class ContactPickerHandler: NSObject, CNContactPickerDelegate {
        func contactPicker(_ picker: CNContactPickerViewController, didSelect contacts: [CNContact]) {
            // 处理选中的联系人逻辑
        }
    }
    

• 清理项目缓存
  很多时候这种报错是Xcode的缓存导致的，执行以下操作：

  1. 按下Cmd + Shift + K清理项目构建文件
  2. 前往~/Library/Developer/Xcode/DerivedData，删除当前项目对应的文件夹
  3. 重启Xcode后重新构建项目

• 避免在桥接层直接传递Contacts类型
  如果你的Swift代码需要向Objective-C返回CNContact相关对象，尽量不要直接暴露这些类型给Objective-C，而是转换成基础类型（比如字典、字符串数组），这样可以减少桥接文件对Contacts框架的依赖，从根源上避免循环导入问题。

如果以上方法都试过还是不行，你可以试试把联系人选择的逻辑完全封装在Swift文件中，通过闭包回调的方式把选中的手机号传递给Objective-C代码，而不是依赖代理协议跨语言调用，这种方式能彻底避开桥接文件的循环问题。

内容的提问来源于stack exchange，提问作者Emre Gürses