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

问题描述

执行 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 中均已正常可用。