M1 Mac终端及VSCode运行pip提示command not found如何修复

你之前手动删除Python相关文件是pip命令失效的直接原因。
M1系列Mac的Python环境本身存在多路径共存的情况：系统自带Python、Homebrew安装的Python、官网pkg包安装的Python分别存放在不同目录，且靠软链接关联到终端可执行路径。手动删除任意Python相关文件、软链接，或是误删环境变量配置，都会导致终端无法定位到pip的可执行文件，触发command not found报错。

补充：macOS 12及以上版本的系统默认不再提供无后缀的python、pip全局指令，默认仅保留python3、pip3的软链接，直接输入pip本身就会报错，不属于故障。

场景1：Python本体未损坏，仅pip失效 #

先在终端执行以下命令验证Python本体状态：

which python3
python3 --version

如果上述命令能正常返回Python3的安装路径、版本号（如Python 3.9.6），说明Python主程序完好，按以下步骤修复：

• 用Python自带的引导工具重装pip，不需要额外下载安装包：

python3 -m ensurepip --upgrade

• 重建pip的全局软链接（M1 Mac全局可执行文件默认路径为/opt/homebrew/bin）：

ln -sf $(python3 -m site --user-base)/bin/pip3 /opt/homebrew/bin/pip3

• 刷新终端配置让软链接生效：

source ~/.zshrc

• 验证修复结果：执行pip3 --version，如果正常返回pip版本、对应Python路径即为修复成功。如果习惯输入pip调用指令，直接在~/.zshrc文件末尾加一行alias pip=pip3，再执行一次source命令即可。

场景2：Python本体软链接已被删除 #

如果执行python3 --version同样返回command not found，说明Python主程序的关联也被破坏，直接用Homebrew重装Python是最稳定的方案，不需要手动恢复系统文件：

• 已安装Homebrew的用户直接执行：

brew install python

• 未安装Homebrew的用户可先完成Homebrew部署，再执行上述Python安装命令即可。Homebrew安装Python过程中会自动配置好python3、pip3的全局软链接和环境变量，安装完成后直接执行pip3 --version验证即可。

• 不要手动删除以下路径下的任何Python相关文件，避免再次出现环境故障：
  • 系统依赖用Python路径：/System/Library/Frameworks/Python.framework/，删除可能导致系统功能异常
  • Homebrew安装Python路径：/opt/homebrew/Cellar/python@3.x/
  • 官网安装包部署的Python路径：/Library/Frameworks/Python.framework/Versions/
• 后续安装Python第三方包推荐使用python3 -m pip install <包名>的写法，能自动匹配当前终端调用的Python版本，避免多版本环境下pip指向错误、包装完找不到的问题。

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