Xcode多框架目标项目中框架依赖模块找不到问题求助

针对你遇到的这个纯Objective-C多框架+Pods的模块找不到问题，我整理了几个针对性的排查和修复步骤，你可以逐一尝试：

1. 检查框架的Modulemap文件配置 #

因为你用了use_frameworks!，每个Pod和自定义框架都需要正确的模块映射才能被识别：

• 打开TUModels的Build Settings，搜索Module Map File，确认路径指向正确的module.modulemap文件（通常在$(SRCROOT)/TUModels/或者Pods生成的对应目录里）。
• 确保module.modulemap的声明格式正确：

  module TUModels {
      header "TUModels.h"
      export *
  }
  

  同时检查Pods_TUModels对应的modulemap，确认它正确引用了JSONModel，比如是否包含@import JSONModel;或者在模块声明里关联了相关头文件。

2. 验证Target的依赖搜索路径 #

• 对于TUSystemKit目标，在Build Settings的Framework Search Paths里，确保包含TUModels框架的生成路径（比如$(BUILT_PRODUCTS_DIR)或者TUModels的项目根目录），并且设置为recursive。
• 同样检查TUModels目标的Framework Search Paths，确认它包含Pods_TUModels和JSONModel框架的路径。

3. 清理重建项目缓存 #

缓存异常是这类问题的常见诱因，彻底清理后再重建：

• 执行终端命令：pod deintegrate彻底移除Pods集成，然后重新执行pod install。
• 在Xcode里按下Cmd+Shift+K清理项目，再按Cmd+Option+Shift+K清理Derived Data。
• 关闭Xcode，手动删除~/Library/Developer/Xcode/DerivedData下对应项目的文件夹，再重新打开项目。

4. 检查Link Binary With Libraries配置 #

• 确认TUSystemKit的Build Phases -> Link Binary With Libraries中已经添加了TUModels.framework，且状态为Required。
• 确认TUModels的Link Binary With Libraries中添加了Pods_TUModels.framework和JSONModel.framework，同样设置为Required。

5. 确认Podfile的目标关联是否正确 #

确保Podfile里每个自定义框架目标都正确绑定了对应的Pods，比如：

use_frameworks!

target 'TUModels' do
  pod 'JSONModel'
end

target 'TUSystemKit' do
  # 如果TUSystemKit不需要直接依赖JSONModel，仅依赖TUModels即可
  target 'TUModels'
end

避免出现依赖遗漏，确保每个目标的Pods都被正确安装到对应框架目录。

6. 检查自定义框架的Public Headers设置 #

对于TUModels框架，确保所有需要被TUSystemKit引用的头文件，都被添加到Build Phases -> Headers -> Public部分，而非Project或Private分类。只有Public目录下的头文件，才能被外部模块正确识别。

内容的提问来源于stack exchange，提问作者Can Poyrazoğlu