M2 Ultra设备启用Metal安装llama-cpp-python失败求助

步骤1：安装完整Xcode（而非仅xcode-select） #

仅安装xcode-select会缺失Metal相关组件，需完成以下操作：

• 打开App Store搜索并安装Xcode 15.3（匹配你的xcode-select版本）
• 安装完成后启动Xcode一次，同意许可协议并完成组件安装
• 强制指定Xcode路径：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

步骤2：验证Metal工具可用性 #

运行以下命令确认metal工具可正常调用：

xcrun metal --version

若能输出版本号，说明环境修复成功；若仍报错，重启终端后重试。

步骤3：重新执行安装命令 #

先激活你的conda环境，再执行：

CMAKE_ARGS="-DLLAMA_METAL=on" pip install -U llama-cpp-python --no-cache-dir

或分步骤设置环境变量后安装：

export CMAKE_ARGS="-DLLAMA_METAL=on"
export FORCE_CMAKE=1
pip install -U llama-cpp-python --no-cache-dir

步骤4：排查conda环境的PATH冲突 #

如果问题依旧，检查系统PATH是否被conda环境覆盖：

• 执行echo $PATH，确认/Applications/Xcode.app/Contents/Developer/usr/bin处于PATH靠前位置
• 若位置靠后或缺失，临时添加路径后重试安装：

  export PATH="/Applications/Xcode.app/Contents/Developer/usr/bin:$PATH"
  

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