一、核心前提
macOS 上构建的核心前提是:xcodebuild命令必须能正常执行并返回版本信息。
虽然已安装 Command Line Tools 且xcrun正常,但build_usd.py内部调用的apple_utils.py会强制执行xcodebuild -version。如果该命令因许可未接受或工具链损坏而失败,脚本就会捕获到None并触发你遇到的.split()报错。
二、精准修复步骤
请按顺序执行以下操作,通常在步骤 1 或 2即可解决问题。
1、手动诊断xcodebuild状态
在终端直接运行以下命令,观察真实输出:
xcodebuild-version- 正常输出:应显示类似
Xcode 15.x.x和Build version xxxxx。 - 异常输出:若提示需要同意许可、找不到工具或要求安装完整版 Xcode,请继续执行后续步骤。
2、接受 Xcode 许可协议(最常见原因)
如果上一步提示需要同意许可协议,请在终端运行以下命令接受协议(需要输入 macOS 登录密码):
sudoxcodebuild-licenseaccept执行后再次运行xcodebuild -version验证是否恢复正常。
3、重置 Command Line Tools
如果xcodebuild依然报错或无响应,说明当前的命令行工具链已损坏或与当前 macOS 版本不匹配。请彻底清理并重新安装:
# 1. 删除现有的命令行工具sudorm-rf/Library/Developer/CommandLineTools# 2. 重新触发安装弹窗xcode-select--install安装完成后,务必再次验证xcodebuild -version能否正常输出版本号。
4、指定完整版 Xcode(如需)
部分 macOS 版本在仅安装 Command Line Tools 时,xcodebuild仍会报错要求完整版 Xcode。如果你已安装完整版 Xcode(通常在/Applications/Xcode.app),请显式指定路径:
sudoxcode-select-s/Applications/Xcode.app三、重新执行构建
当xcodebuild -version能正常输出后,你的 Python 3.10 环境已完全满足官方要求。此时重新运行构建命令即可:
/opt/miniconda3/envs/py310/bin/python OpenUSD/build_scripts/build_usd.py usd_install/提示:OpenUSD 首次构建会下载并编译 TBB、OpenSubdiv 等多个第三方依赖,耗时较长(通常 15-30 分钟),请保持网络畅通并耐心等待。如果仍有报错,请将
xcodebuild -version的具体输出发给我,我为你进一步定位。