Xcode 15.2编译iOS模拟器时出现无法构建模块错误

问题背景 #

编译基于Capacitor的React Native项目时，使用Xcode 16.2针对iPhoneSimulator18.2.sdk构建，触发多个Could not build module错误，涉及runetype、CoreFoundation、sys_types、Darwin等系统模块。

已尝试操作 #

• 清理构建文件夹（Cmd + Shift + K 以及通过Product菜单选择Clean Build Folder）
• 删除Derived Data：执行命令 rm -rf ~/Library/Developer/Xcode/DerivedData/
• 通过Mac App Store卸载后重装Xcode
• 检查SDK安装：执行命令 xcode-select --install
• 切换到正确的Xcode版本：执行命令 sudo xcode-select --switch /Applications/Xcode.app
• 重新执行CocoaPods安装：pod install

项目基础信息 #

• Xcode版本：16.2
• 目标SDK：iPhoneSimulator18.2.sdk
• 项目类型：Capacitor React Native项目
• 依赖管理：CocoaPods

错误日志示例 #

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator18.2.sdk/usr/include/_ctype.h:71:10 Could not build module 'runetype'
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator18.2.sdk/usr/include/_stdio.h:421:10 Could not build module 'sys_types'
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator18.2.sdk/System/Library/Frameworks/CoreGraphics.framework/Headers/CGBase.h:12:10 Could not build module 'CoreFoundation'
...

额外排查与修复步骤 #

1. 验证SDK完整性 #

打开Xcode的Settings > Platforms，找到iOS Simulator 18.2，右键选择"Show in Finder"，检查SDK文件夹内的usr/include目录和框架文件是否完整。若存在缺失：

• 回到Xcode Settings，选中iOS Simulator 18.2，点击右下角的-删除，再点击+重新下载安装该SDK。

2. 重置Xcode组件缓存 #

执行以下命令清理Xcode的缓存文件，之后重启Xcode：

rm -rf ~/Library/Caches/com.apple.dt.Xcode
rm -rf ~/Library/Developer/Xcode/Archives
rm -rf ~/Library/Developer/Xcode/iOS DeviceSupport

3. 检查项目Build Settings配置 #

• 打开项目Target的Build Settings，搜索SDKROOT，确认值为iPhoneSimulator18.2.sdk，且未手动修改过路径。
• 搜索Header Search Paths和Framework Search Paths，确保没有添加指向旧版SDK或无效的路径，建议保留默认配置。

4. 修复CocoaPods环境 #

先更新CocoaPods到最新版本，再重新初始化依赖：

sudo gem install cocoapods
cd [你的项目iOS目录]
pod deintegrate
pod clean
pod install

完成后务必打开项目的.xcworkspace文件，而非.xcodeproj。

5. 确认Xcode权限 #

• 打开系统设置 > 隐私与安全性 > 文件与文件夹，找到Xcode，勾选所有相关的文件夹权限。
• 执行命令重新接受Xcode许可：

  sudo xcodebuild -license accept
  

6. 测试新建项目验证环境 #

用Xcode新建一个空的iOS模拟器项目，选择iPhoneSimulator18.2.sdk编译。若同样报错，说明是Xcode或SDK本身的问题，需彻底卸载后重装：

sudo rm -rf /Applications/Xcode.app
rm -rf ~/Library/Developer/Xcode
rm -rf ~/Library/Caches/com.apple.dt.Xcode
rm -rf ~/Library/Preferences/com.apple.dt.Xcode.plist

之后从Apple Developer官网下载Xcode安装包（避免使用App Store），重新安装并配置。

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