iOS构建环境冲突：Library未加载与重复命令问题求助

问题本质 #

单台笔记本的CocoaPods依赖解析或缓存异常，导致Foo.framework未被正确引入项目；手动添加框架后，又与其他环境中CocoaPods自动生成的构建命令冲突，引发「Multiple commands produce」错误。

统一配置+单环境修复方案 #

1. 恢复全局一致的项目配置 #

先移除手动添加到Xcode的Foo.framework：

• 打开Xcode项目，在Target > Build Phases > Link Binary With Libraries中删除Foo.framework
• 若曾手动添加过复制框架的任务，在Target > Build Phases > Copy Files中删除对应条目
• 提交修改，确保所有环境使用统一的项目文件

2. 清理问题机器的缓存与依赖 #

在问题笔记本的项目根目录执行以下命令：

# 彻底移除Pods集成
pod deintegrate
# 删除Xcode衍生数据
rm -rf ~/Library/Developer/Xcode/DerivedData
# 删除本地Pods目录和锁文件
rm -rf Pods Podfile.lock
# 重新安装依赖
pod install

完成后重启Xcode，按下Cmd+Shift+K清理项目，再尝试构建。

3. 验证关键配置 #

• 检查Podfile中是否正确声明了Foo依赖：pod 'Foo'
• 确认Xcode的Build Settings：
  • FRAMEWORK_SEARCH_PATHS包含$(inherited)和${PODS_ROOT}/Foo
  • LD_RUNPATH_SEARCH_PATHS包含@executable_path/Frameworks和@loader_path/Frameworks

4. 修复目录权限（可选） #

如果缓存清理无效，检查项目目录权限：

sudo chown -R $(whoami) /path/to/your/project

原因说明 #

问题机器的CocoaPods本地缓存或Xcode衍生数据损坏，导致依赖框架未被自动注入到构建流程中；手动添加框架后，CocoaPods的自动构建任务和手动添加的任务同时尝试复制Foo.framework到目标路径，触发Xcode的重复构建命令错误。

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