目录
彻底卸载 macOS 上所有版本的 Python(包括系统自带的、Homebrew 安装的、手动安装的等)。
注意:macOS 自带的 Python 2.x 或 3.x 系统依赖它,请不要删除系统版本,否则可能导致 macOS 工具(如 xcode-select、brew、git)异常。
卸载 macOS 上所有版本的 Python
查看已安装的 Python
先打开终端,执行:
which -a python which -a python3 ls -l /Library/Frameworks/Python.framework/Versions/ ls -l /usr/local/bin/python*
这会显示所有 Python 路径,比如:
/usr/bin/python3 ← 系统自带(不要删) /usr/local/bin/python3.11 ← 用户安装的(可删) /Library/Frameworks/Python.framework/Versions/3.11
卸载通过官方安装包(.pkg/.dmg)安装的 Python
如果是从 python.org 安装的:
执行以下命令(以 3.11 为例):
sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.11 sudo rm -f /Applications/Python\ 3.11 sudo rm -f /usr/local/bin/python3.11 sudo rm -f /usr/local/bin/pip3.11 sudo rm -f /usr/local/bin/idle3.11
如果有多个版本,重复执行上面命令替换版本号(3.9、3.10、3.12 等)。
卸载 Homebrew 安装的 Python
如果曾用 brew install python 安装:
brew uninstall python brew cleanup
然后确认是否删除干净:
which python3 brew list | grep python
删除用户环境中可能残留的配置
rm -rf ~/Library/Python rm -rf ~/.local/lib/python* rm -rf ~/.pyenv rm -rf ~/.virtualenvs
如果用过 pyenv 安装 Python:
brew uninstall pyenv rm -rf ~/.pyenv
检查系统是否还有 Python(保留系统版本)
python3 --version which python3
正常情况下,系统还会有一个 /usr/bin/python3(macOS 自带的安全版本)。
(可选)清理 PATH 环境变量
编辑 shell 配置文件(根据用的 shell):
- Bash →
~/.bash_profile - Zsh →
~/.zshrc
删除类似:
export PATH="/usr/local/opt/python@3.11/bin:$PATH" export PATH="/Library/Frameworks/Python.framework/Versions/3.11/bin:$PATH"
保存后执行:
source ~/.zshrc
验证卸载结果
which -a python which -a python3
输出应只剩下系统路径 /usr/bin/python3。
macOS Python 一键卸载脚本
- 自动检测并卸载所有非系统版本的 Python(包括官方安装包、Homebrew、Pyenv 等)
- 不会删除 macOS 自带的系统 Python(安全)
- 删除 pip 缓存、虚拟环境和 PATH 中的无效路径
使用方法
第一步:复制下面脚本到一个文件
在终端执行:
nano ~/uninstall_python.sh
然后把下面内容完整复制进去
保存退出(Ctrl + O → 回车 → Ctrl + X)。
脚本内容:
#!/bin/bash echo "==============================" echo "