彻底告别 `xcode-select: Failed to locate 'python'`！M1 Mac 开发环境踩坑实录

一、起因：一个 `make config` 引发的血案

最近在学习DeerFlow，在生成本地配置文件时，在终端执行 make config ，报错提示

xcode-select: Failed to locate 'python', requesting installation of command line developer tools.

明明电脑里装了 python3，也配置了软链接

sudo ln -sf /usr/bin/python3 /usr/local/bin/python

which python 和 which python3 都能返回路径，可系统偏偏卡在这里不断弹窗。

在找到终极方案前，我尝试了社区里最常见的几种方法，结果通通翻车：

设置 Alias（别名） ：
- alias python=python3
- 结果：交互式终端有效，但 make 启动的是子 Shell，根本不读你的 alias。
修改 ~/.zprofile 的 PATH：
- export PATH="/usr/local/bin:$PATH"
- 结果：即便软链接指向了 Python 3，由于某些 Makefile 硬编码了路径，依然会被系统 /usr/bin/python 拦截。
重装 Xcode Command Line Tools：
- 结果：报错依然如旧。

手动执行下面命令可以正常执行

make config PYTHON=python3

那有没有不需要手动修改，直接就能执行呢？

经过一番摸索，我发现了 macOS 开发者环境的两个核心真相：

macOS 系统目录 /usr/bin 的优先级极高。里面那个 python 实际上是一个 Shim（垫片） 。它不指向任何真实的解释器，它的唯一作用就是检测你有没有安装完整的 Xcode。

make 工具在寻找编译器和解释器时，会优先咨询 xcode-select 定义的路径。如果这个路径指向了错误的 SDK，或者路径下缺少 python 这个软链接，构建就会崩溃。

首先，我们要确保 xcode-select 指向的是独立的命令行工具目录，而不是那个几 GB 大的 Xcode App（或错误的路径）。

# 强制指定活动目录为独立命令行工具
sudo xcode-select -s /Library/Developer/CommandLineTools

这是最暴力也最有效的一步。既然某些构建工具死活要去 CommandLineTools 的内部找名为 python 的执行文件，那我们就直接在它老巢里建一个。

# 进入工具链内部，让 python 名正言顺地导向 python3
sudo ln -s /Library/Developer/CommandLineTools/usr/bin/python3 /Library/Developer/CommandLineTools/usr/bin/python

为了确保以后 pip 或其他 Python 脚本能正常工作，建议在 ~/.zprofile 的最末尾加上 Homebrew 的环境注入：

# 确保 Homebrew 和自定义路径拥有最高优先级
eval "$(/opt/homebrew/bin/brew shellenv)"
export PATH="/usr/local/bin:$PATH"

刷新配置：source ~/.zprofile。再次验证，丝滑顺畅：

make config        # 完美运行，不再弹窗！