Xcode编译报错：找不到SDWebImage模块及相关构建错误求助

使用Xcode 13.4.1编译项目时失败，出现4个明确错误：

• Command EmitSwiftModule failed with a nonzero exit code
• error: accessing build database "/Users/myuser/Library/Developer/Xcode/DerivedData/App-btdfdbatbdurmeawknwdwmjrqpsw/Build/Intermediates.noindex/XCBuildData/build.db": disk I/O error
• Virtual filesystem overlay file '/Users/myuser/Library/Developer/Xcode/DerivedData/App-btdfdbatbdurmeawknwdwmjrqpsw/Build/Intermediates.noindex/App.build/Debug-iphoneos/App DEV.build/all-product-headers.yaml' not found
• /Users/myuser/myapp-ios-app/App/UI/Feed/FeedVC/FeedVC.swift:11:8: No such module 'SDWebImage'

已尝试清理项目、重置Pods缓存、删除DerivedData、更新Pods、清理Xcode偏好设置、Podfile添加:modular_headers => true、重新下载项目、改用SPM引入SDWebImage、手动添加头文件等方案，均未解决。新建项目使用相同Pods可正常运行，但无法直接迁移现有项目。

1. 彻底重建Pods环境 #

执行以下命令完全清理Pods相关文件后重新安装：

rm -rf Pods/ Podfile.lock
pod cache clean --all
pod install --repo-update

安装完成后关闭Xcode，重新打开项目的.xcworkspace文件编译。

2. 排查磁盘问题 #

磁盘I/O错误大概率和权限或空间有关：

• 检查项目所在磁盘剩余空间，确保预留至少10GB以上编译空间
• 右键项目文件夹→「显示简介」，确认当前用户拥有「读与写」权限
• 重启Mac释放系统缓存和资源

3. 修改DerivedData路径 #

Xcode默认的DerivedData路径可能存在权限冲突，尝试自定义路径：

1. 打开Xcode→「Preferences」→「Locations」
2. 点击「DerivedData」后的箭头打开文件夹，删除所有内容
3. 点击「Advanced」选择「Custom」，设置一个新路径（比如用户目录下新建XcodeDerivedData文件夹）
4. 重启Xcode后重新编译

4. 检查Build Settings配置 #

针对SDWebImage找不到的问题，核对以下配置：

• 确认Podfile中SDWebImage的拼写和版本正确
• 进入项目Target的「Build Settings」，搜索「Framework Search Paths」，确保包含$(inherited)
• 搜索「Header Search Paths」，同样添加$(inherited)，确保Pods头文件路径被正确引入

5. 验证Scheme配置 #

确认当前Scheme无配置错误：

1. 点击Xcode顶部Scheme选择框→「Edit Scheme」
2. 进入「Build」选项卡，确认「Build Configuration」为对应环境，且所有必要Target已勾选
3. 关闭Xcode后删除~/Library/Developer/Xcode/UserData/SharedPrecomputedContexts文件夹，清理Scheme缓存

6. 对比同事的项目配置 #

同事项目可正常运行，可对比以下内容：

• 对比Podfile和Podfile.lock，确保依赖版本完全一致
• 对比项目Target的Build Settings，重点核对Pods相关配置项
• 暂存本地所有修改，尝试编译，排查是否是本地文件修改导致的问题

内容的提问来源于stack exchange，提问作者João Serra