M1 MacBook无法执行Python，创建软链接后仍报错求助

问题现象 #

执行python命令提示找不到，创建软链接后仍触发Xcode命令行工具安装提示，但python3可正常使用：

luis@LuisdeMacBook-Pro ~ % python
zsh: command not found: python
luis@LuisdeMacBook-Pro ~ % ln -s /usr/bin/python3 /usr/local/bin/python
ln: /usr/local/bin/python: Permission denied
luis@LuisdeMacBook-Pro ~ % sudo ln -s /usr/bin/python3 /usr/local/bin/python
luis@LuisdeMacBook-Pro ~ % python
python: error: Failed to locate 'python'.
xcode-select: Failed to locate 'python', requesting installation of command line developer tools.

原因 #

M1芯片的MacOS中，系统对python命令的查找逻辑可能优先调用Xcode相关工具，而非用户创建的软链接；另外/usr/local/bin的PATH优先级可能低于系统默认路径，导致软链接无法被优先识别。

解决方法 #

方法一：配置Shell别名（推荐，无需修改系统目录） #

• 打开zsh配置文件：

  open ~/.zshrc
  

• 在文件末尾添加一行：

  alias python='python3'
  

• 保存文件后，执行以下命令使配置生效：

  source ~/.zshrc
  

之后再执行python就会直接调用python3，不会再触发安装提示。

方法二：安装官方Python版本 #

下载适配M1芯片的Python官方安装包并完成安装，官方程序会自动在/usr/local/bin创建正确的python软链接，替代系统默认的查找逻辑。

方法三：修复软链接并调整PATH优先级 #

• 先删除已创建的无效软链接：

  sudo rm /usr/local/bin/python
  

• 重新创建软链接：

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

• 确保/usr/local/bin在PATH的最前面，打开~/.zshrc添加：

  export PATH="/usr/local/bin:$PATH"
  

• 执行source ~/.zshrc生效，之后再测试python命令。

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