Unreal Engine生成项目文件时提示MacOSX.sdk缺失报错如何解决？

错误核心原因：Unreal Build Tool默认优先从Xcode.app路径读取MacOSX SDK，当系统活动开发者路径指向独立CommandLineTools、或CommandLineTools未包含完整MacOSX SDK时，就会触发路径不存在报错。

按照以下步骤逐一排查修复即可：

• 第一步：安装完整Xcode
  不要仅安装独立CommandLineTools工具包，请从App Store或苹果开发者官网下载与当前UE版本兼容的完整Xcode安装包，安装完成后首次打开Xcode，同意用户许可并等待自动安装所需配套组件。
• 第二步：切换活动开发者路径
  打开终端执行命令，将系统默认开发者路径切换到Xcode.app内部路径：
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  执行完成后验证路径是否正确：
  xcode-select -p
  输出结果为/Applications/Xcode.app/Contents/Developer即为配置正确。
• 第三步：验证SDK可用性
  终端执行命令确认MacOSX SDK可被正常识别：
  xcrun --sdk macosx --show-sdk-path
  正常会输出类似/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk的路径，此时可重试生成UE项目文件，多数情况到这一步即可解决问题。
• 第四步：手动创建软链接兼容旧版UE
  如果执行完上述步骤仍报错，可手动将Xcode内的SDK目录软链接到UE报错的查找路径：
  先创建对应层级的空目录（如果目录不存在）：
  sudo mkdir -p /Library/Developer/CommandLineTools/Platforms/MacOSX.platform/Developer
  再执行软链接命令：
  sudo ln -s /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs /Library/Developer/CommandLineTools/Platforms/MacOSX.platform/Developer/SDKs

额外注意事项 #

• 请确保Xcode版本与UE版本兼容，例如UE5.3及以上版本需要Xcode15及以上版本支持，版本不兼容也会导致SDK识别失败
• 后续更新Xcode后建议重新执行第二步的路径切换命令，避免路径失效

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