Xcode提示Dependencies could not be resolved错误如何解决

基础环境重置 #

• 首先确认Xcode命令行工具指向正确：打开Xcode设置-Locations面板，Command Line Tools选项选中当前正在使用的正式版Xcode，不要指向beta版或旧版本，选中后终端执行命令生效：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

• 完全重装项目CocoaPods依赖，在项目根目录依次执行以下命令：

  pod deintegrate
  rm -rf Pods
  rm Podfile.lock
  pod cache clean --all
  pod install
  

  注意2021款MacBook Pro为Apple Silicon芯片，执行pod命令时不要给终端开启Rosetta转译，原生执行即可。命令执行完成后完全退出Xcode，仅打开项目生成的.xcworkspace文件，不要打开.xcodeproj文件。

构建配置对齐检查 #

• 打开项目主target的Build Settings面板，找到Excluded Architectures配置项，记录当前配置值，再切换到Pods项目下的所有target，把该配置项改成和主target完全一致的值，避免出现主target排除了某架构但Pods依赖包编译了对应架构导致链接失败。
• 找到Build Active Architecture Only配置项，Debug模式设为Yes，Release模式设为No，同样同步Pods下所有target的该配置和主target一致。
• 如果使用Xcode 14及以上版本，选中Pods项目，在Build Settings里找到Validate Workspace设为Yes，触发一次构建，构建完成后可改回原值，该操作会强制Xcode重新校验Pods和主项目的关联配置。

签名与脚本路径检查 #

• 打开Pods项目的Signing & Capabilities面板，所有Pods target的Team选项、Signing Certificate选项和主target保持一致，不要默认选Don't Code Sign，避免签名阶段报错。
• 选中主target，切换到Build Phases面板，检查[CP] Embed Pods Frameworks、[CP] Copy Pods Resources两个脚本阶段的路径配置，确认没有指向已被清理的旧DerivedData残留路径。

全量缓存清理 #

以上操作都无效时，执行全量缓存重置：

• 完全退出Xcode
• 终端执行命令删除全局Xcode缓存：

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

• 重启设备后重新打开.xcworkspace构建。

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