在 macOS 上完全卸载 Python 需要根据安装方式采取不同的步骤,核心是卸载主程序、删除残留文件与配置、清理环境变量,同时强烈建议不要删除系统自带的 Python 2.7,仅处理用户自行安装的版本。以下是详细指南:
-
系统自带:macOS 通常预装 Python 2.7(路径
/usr/bin/python),部分新系统已移除。此版本用于系统工具,不建议删除。 -
用户安装:
- 官方 pkg 安装包:从 python.org 下载安装,版本号如 3.x,路径通常为
/Library/Frameworks/Python.framework/Versions/x.x。 - Homebrew 安装:通过
brew install python安装,路径为/usr/local/bin/python3或/opt/homebrew/bin/python3(M1 芯片)。 - 其他:如 pyenv、Anaconda 等。
- 官方 pkg 安装包:从 python.org 下载安装,版本号如 3.x,路径通常为
A. 卸载 Homebrew 安装的 Python
-
卸载 Python 包:
brew uninstall python@3.x # 替换为实际版本,如 python@3.11 brew cleanup -s python@3.x # 清理残留 -
删除符号链接(如果存在):
sudo rm /usr/local/bin/python3 sudo rm /usr/local/bin/pip3
B. 卸载官方 pkg 安装的 Python
-
删除框架目录:
sudo rm -rf /Library/Frameworks/Python.framework/Versions/x.x # 替换版本号 -
删除应用目录:
sudo rm -rf "/Applications/Python x.x" # 版本号含空格,需加引号 -
删除可执行文件和符号链接:
sudo rm /usr/local/bin/python3 sudo rm /usr/local/bin/pip3
C. 卸载其他方式安装的 Python
-
pyenv 管理的 Python:
pyenv uninstall 3.x.x # 卸载指定版本 rm -rf ~/.pyenv # 完全移除 pyenv -
Anaconda/Miniconda:
conda install anaconda-clean anaconda-clean --yes rm -rf ~/anaconda3 ~/miniconda3
-
删除用户目录下的配置和缓存:
rm -rf ~/Library/Python/x.x # 用户级包 rm -rf ~/.local/bin/pip3 rm -rf ~/.cache/pip rm -rf ~/.pyenv -
清理环境变量:
-
编辑
~/.bash_profile、~/.zshrc或~/.profile文件,移除以下类似行:bash 暗色 复制 export PATH="/Library/Frameworks/Python.framework/Versions/3.x/bin: $ PATH" -
保存后执行:
source ~/.zshrc # 或 source ~/.bash_profile
-
-
检查 Python 命令:
python3 --version # 应返回 "command not found" which python3 # 应无输出或指向 /usr/bin/python3(系统自带) -
检查残留文件:
mdfind -name python | grep -v "/System/" # 查看非系统残留
- 不要删除系统自带的 Python 2.7:位于
/usr/bin/python,删除可能导致系统工具异常。 - 备份重要数据:卸载前备份项目或虚拟环境。
- 使用虚拟环境:未来建议用
pyenv或virtualenv隔离项目环境。
一键卸载脚本(高级用户)
部分开发者提供官方卸载脚本或自定义脚本,但需谨慎使用:
curl -o uninstall.py https://raw.githubusercontent.com/python/cpython/main/Tools/scripts/uninstall.py
python3 uninstall.py --verbose
综上,macOS 完全卸载 Python 的关键是:
确定安装方式 → 卸载主程序 → 清理残留文件和环境变量 → 验证结果。
始终保留系统自带 Python,仅处理用户安装的版本,以避免系统异常。