Xcode项目编译时出现‘No such module found’错误求助

问题现象 #

• 编译时提示指定模块找不到，但打开报错文件几秒后错误自动消失
• 输入import时自动补全能识别对应模块，证明模块实际存在
• 不同设备报错模块不同：M1设备提示缺失ParseSwift，iMac提示缺失Google-Mobile-Ads-SDK
• 升级Xcode 14.3后出现该问题，回退到14.2后问题仍存在
• 已尝试pod deintegrate、删除podfile.lock/.xcworkspace、清理DerivedData、重新pod install等操作，均无效
• 项目及所有Pods的最低iOS部署版本均为12.0，其他使用CocoaPods的项目可正常编译

解决方案 #

1. 适配M1设备架构（针对Apple Silicon设备）

在Podfile末尾添加架构兼容配置，避免模拟器与真机架构冲突：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # 限制模拟器架构为64位，排除arm64
      config.build_settings['ARCHS[sdk=iphonesimulator*]'] = '$(ARCHS_STANDARD_64_BIT)'
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
    end
  end
end

执行pod install后，重新打开.xcworkspace编译。

2. 检查项目Build Settings配置

• 打开项目Build Settings，搜索Framework Search Paths，确保包含$(inherited)和${PODS_ROOT}/**，这两个路径会自动引入Pods的框架文件
• 搜索Other Linker Flags，确认包含$(inherited)，该配置会自动加载Pods的链接参数
• 针对Widget Extension目标，重复以上检查，确保其框架搜索路径和链接参数与主项目一致

3. 重置Xcode索引缓存

除了常规清理DerivedData，强制重置索引可解决识别延迟问题：

1. 关闭Xcode
2. 执行命令清理DerivedData：

   rm -rf ~/Library/Developer/Xcode/DerivedData
   

3. 重置Xcode索引配置：

   defaults delete com.apple.dt.Xcode IDEIndexDisable
   

4. 重新打开Xcode，等待索引完成后再尝试编译

4. 切换为静态框架链接

将use_frameworks!改为静态框架链接，可能解决模块识别的时序问题：
修改Podfile中的use_frameworks!为：

use_frameworks! :linkage => :static

依次执行pod deintegrate、pod install，重新打开项目编译。

5. 验证Pods工作区加载状态

• 打开.xcworkspace后，检查左侧导航栏的Pods项目是否正常加载（无红色感叹号）
• 进入主项目的Build Phases → Link Binary With Libraries，确认对应Pod框架（如ParseSwift、Google-Mobile-Ads-SDK）已被添加，若缺失可从Pods项目中手动拖入

6. 清理系统级Xcode缓存

执行以下命令清理系统缓存后重启电脑：

sudo rm -rf /Library/Caches/com.apple.dt.Xcode
rm -rf ~/Library/Caches/com.apple.dt.Xcode

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