Xcode 15 混编Swift/Objective-C项目归档时出现未定义符号错误

核心排查方向：确保Swift类的符号被正确导出到归档构建中 #

1. 完善Swift类的Objective-C兼容声明 #

• 确保AClass明确继承自NSObject，仅添加@objc不足以让类符号被Objective-C识别，必须继承Objective-C根类：

  @objc class AClass: NSObject {
      // 类实现内容
  }
  

• 若涉及类扩展，使用@objcMembers标记扩展，确保所有成员符号都能被导出：

  @objcMembers extension AClass {
      // 扩展实现内容
  }
  

2. 验证Swift文件的Target归属 #

• 进入项目Build Phases > Compile Sources，确认AClass.swift已添加到**归档对应的Target（通常是Release配置的主Target）**中，避免仅勾选了Debug/模拟器架构的Target。
• 检查是否存在重复添加的Swift文件，或文件被错误归类到其他无关Target。

3. 调整归档构建的编译设置 #

• 进入Build Settings > Swift Compiler - Code Generation：
  • 确认Objective-C Generated Interface Header Name已正确配置（如YourProject-Swift.h），且Objective-C文件中正确引入该兼容性头文件，而非直接引用Swift类的自定义头。
  • 确保Install Objective-C Compatibility Header设置为Yes，保证兼容性头文件在归档构建中正常生成。
• 检查Build Settings > Linking下的Dead Code Stripping：Release归档默认开启该选项，可能误删未被直接引用的Swift类符号。临时设置为No后重新归档测试，若问题解决，再针对性调整代码确保类被有效引用，而非全局关闭该优化。

4. 排查Bitcode与架构配置问题 #

• 检查Build Settings > Build Options > Enable Bitcode：若归档开启Bitcode而模拟器未开启，可能导致符号生成差异。临时关闭Bitcode（设置为No）后重新归档，验证是否为Bitcode编译导致的问题。
• 手动切换到Generic iOS Device（或对应归档目标设备），执行Clean Build Folder（按住Option点击Clean）后再重新归档，避免缓存残留影响符号生成。

5. 检查Swift版本与编译参数 #

• 确保Build Settings > Swift Compiler - Language > Swift Version与当前Xcode版本匹配，避免版本不兼容导致的符号生成异常。
• 对比Debug和Release配置的Other Swift Flags，确保Release配置未添加会隐藏符号的激进优化参数（如-Osize可能触发过度优化导致符号被移除）。

6. 排查依赖库的符号导出 #

若AClass属于项目依赖的静态库/Framework：

• 确保依赖Target在归档构建时也生成了完整的符号，且主Target已正确链接该依赖。
• 检查依赖Target的Deployment Target与主Target一致，避免版本差异导致的符号不兼容。

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