当前位置：首页 > news >正文

卸载 macOS 上所有版本的 Python

news 2026/6/16 3:24:42

卸载 macOS 上所有版本的 Python

彻底卸载 macOS 上所有版本的 Python（包括系统自带的、Homebrew 安装的、手动安装的等）。

⚠️ 注意：macOS 自带的 Python 2.x 或 3.x 系统依赖它，请不要删除系统版本，否则可能导致 macOS 工具（如 xcode-select、brew、git）异常。

🧩 一、查看已安装的 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 "  🧹 macOS Python 一键卸载脚本"
echo "=============================="
echo# 检查权限
if [ "$EUID" -ne 0 ]; thenecho "⚠️  请使用 sudo 运行此脚本：sudo bash ~/uninstall_python.sh"exit
fi# 卸载 Homebrew 安装的 Python
if command -v brew &>/dev/null; thenecho "🍺 正在卸载 Homebrew Python..."brew uninstall --ignore-dependencies python python@3.9 python@3.10 python@3.11 python@3.12 2>/dev/nullbrew cleanup
fi# 删除 python.org 安装包的 Python
echo "🧾 正在删除官方安装包版本..."
for v in 3.9 3.10 3.11 3.12 3.13; dosudo rm -rf /Library/Frameworks/Python.framework/Versions/$vsudo rm -rf "/Applications/Python ${v}"sudo rm -f /usr/local/bin/python${v}sudo rm -f /usr/local/bin/python${v%.*}sudo rm -f /usr/local/bin/pip${v}sudo rm -f /usr/local/bin/idle${v}
done# 删除 pyenv
echo "🐍 正在删除 pyenv..."
brew uninstall pyenv 2>/dev/null
rm -rf ~/.pyenv# 删除虚拟环境和 pip 缓存
echo "🧩 删除虚拟环境和缓存..."
rm -rf ~/.local/lib/python*
rm -rf ~/Library/Python
rm -rf ~/.virtualenvs
rm -rf ~/Library/Caches/pip# 清理 PATH 中的 Python 相关路径
echo "🧠 清理 PATH 配置..."
for f in ~/.bash_profile ~/.bashrc ~/.zshrc; do[ -f "$f" ] && sed -i '' '/Python.framework/d' "$f"[ -f "$f" ] && sed -i '' '/pyenv/d' "$f"[ -f "$f" ] && sed -i '' '/python@/d' "$f"
done# 验证剩余版本
echo
echo "✅ 卸载完成！当前系统保留版本："
which -a python3 || echo "未检测到 Python"
python3 --version 2>/dev/null || echo "无系统 Python 可用"
echo
echo "💡 如果仍检测到非系统路径，可手动检查："
echo "   ls -l /Library/Frameworks/Python.framework/Versions/"