使用Xcode构建Unreal游戏遇Internal inconsistency等错误求助
UE5.3.2 + Xcode15.3 构建错误修复方案
针对你遇到的Internal inconsistency error: never received target ended message和ExternalBuildToolExecution失败错误,试试以下几个实操方案:
彻底清理所有构建缓存
- 关闭Xcode和UE编辑器,删掉项目根目录下的
Intermediate、Saved文件夹 - 打开Xcode,点击顶部菜单
Xcode > 设置 > 位置,找到派生数据,点击右侧箭头打开文件夹,删除当前项目的缓存目录(或者全删) - 终端执行两条命令清理系统级缓存:
rm -rf ~/Library/Caches/com.apple.dt.Xcode rm -rf ~/Library/Developer/Xcode/DerivedData
- 关闭Xcode和UE编辑器,删掉项目根目录下的
调整Xcode项目构建设置
- 打开UE生成的Xcode项目,选中根项目
Test (Mac),切换到Build Settings标签 - 搜索
Parallelize Build,改成No(关闭并行构建,避免M3多核下的资源冲突) - 搜索
macOS Deployment Target,设置为13.0或更高(UE5.3最低要求macOS 13) - 搜索
Architectures,确认设置为arm64(适配M3芯片架构)
- 打开UE生成的Xcode项目,选中根项目
修改UE项目的构建配置
- 打开UE编辑器,进入
项目设置 > 平台 > Mac - 把
构建配置改成Development,先跳过Shipping模式(该模式下缓存和权限问题更多) - 取消勾选
使用Xcode构建系统(实验性),改用传统构建系统 - 点击
清理,然后重新生成Xcode项目:文件 > 打包项目 > Mac > 生成Xcode项目
- 打开UE编辑器,进入
手动执行UE构建命令排查细节
进入项目根目录,在终端执行以下命令手动构建,能看到更详细的错误输出,方便定位问题:./Build.sh Development Mac重置Xcode配置与工具链
- 终端执行
defaults delete com.apple.dt.Xcode重置Xcode偏好设置,然后重启Xcode - 重新安装命令行工具:
xcode-select --install,或者执行xcode-select --reset修复工具链路径
- 终端执行
兼容性兜底方案
如果以上方法都无效,大概率是UE5.3.2与Xcode15.3的适配bug:- 临时降级Xcode到15.2版本(UE5.3.2对这个版本的兼容性更好)
- 升级UE到5.3.3或更高版本,官方后续补丁修复了M3芯片和Xcode15.3的适配问题
内容的提问来源于stack exchange,提问作者devon't
相关产品推荐
相关产品推荐

