macOS12.5+Xcode13.4.1下Python命令依赖问题求助

问题背景 #

• 设备：M1 Pro 2021款MBP，系统macOS 12.5，Xcode 13.4.1
• 核心问题：使用NativeScript开发应用，执行Product > Archive操作时，Xcode反复弹出“Python command requires the command line tools”提示，完成安装后问题依旧；ns doctor ios检测始终提示缺少Python，多次尝试软链接、pyenv配置均无效。
• 已确认：xcode-select -p返回路径为/Applications/Xcode.app/Contents/Developer，系统自带Python3，且已按NativeScript文档配置相关依赖。

解决方案 #

1. 重新关联并安装Xcode命令行工具 #

确保命令行工具与当前Xcode版本完全匹配，避免版本冲突：

# 卸载现有命令行工具（若存在）
sudo rm -rf /Library/Developer/CommandLineTools
# 重新安装
xcode-select --install
# 强制关联到当前Xcode目录
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

2. 修复Xcode内置工具目录的Python软链接 #

Xcode 13.x的构建系统会优先读取自身Developer/usr/bin目录下的工具，因此需要在该目录下创建python指向Python3的软链接，且确保权限正确：

# 删除已存在的无效软链接（若有）
sudo rm -f /Applications/Xcode.app/Contents/Developer/usr/bin/python
# 创建新的软链接指向Xcode内置的Python3
sudo ln -s /Applications/Xcode.app/Contents/Developer/usr/bin/python3 /Applications/Xcode.app/Contents/Developer/usr/bin/python

执行后验证链接有效性：

/Applications/Xcode.app/Contents/Developer/usr/bin/python --version

确认输出为Python 3.x版本即可。

3. 配置NativeScript专属Python环境变量 #

在你的shell配置文件（~/.zshrc或~/.bash_profile）中添加以下内容，强制NativeScript使用Xcode内置的Python：

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

执行以下命令使配置生效：

source ~/.zshrc  # 若使用bash则替换为source ~/.bash_profile

之后重新运行ns doctor ios，检查是否仍提示Python缺失。

4. 清理Xcode缓存并验证构建环境 #

• 打开Xcode，进入Preferences > Locations，确认Command Line Tools选择的是Xcode 13.4.1，而非单独的Command Line Tools。
• 清理Xcode缓存：按下Command + Shift + Option + K，选择清理。
• 重启Xcode，再次尝试Product > Archive操作。

关于Xcode优先读取自身目录工具的说明 #

Xcode的构建系统设计为优先使用自身捆绑的工具链，目的是避免系统环境变量、第三方工具（如pyenv）的干扰，确保不同项目、不同Xcode版本的构建环境一致性。因此即使系统已安装Python3，Xcode仍会优先查找自身目录下的python可执行文件。

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