MacOS:Python `command not found` 问题修复记录

11 阅读1分钟

问题描述

执行 python 命令时报错:

command not found: python

环境信息

  • 系统:macOS
  • Shell:zsh / bash
  • 已安装:Python 3.14.3(路径:/opt/homebrew/bin/python3

根本原因

macOS 12.3 起移除了系统自带的 Python 2,且不再默认将 python 指向 Python 3,需手动配置。

解决方案

方案一:添加别名(仅当前用户 zsh 生效)

echo 'alias python=python3' >> ~/.zshrc
source ~/.zshrc

方案二:创建软链接(全局生效,推荐)

ln -s /opt/homebrew/bin/python3 /opt/homebrew/bin/python 

软链接放在 /opt/homebrew/bin/ 下,zsh 和 bash 均自动生效,无需额外配置。

验证结果

$ python --version
Python 3.14.3

$ bash -c "python --version"
Python 3.14.3

结论

采用方案二(软链接),python 命令在 zsh 和 bash 中均已正常可用。