当前位置:首页 > 软件教程 > 苹果教程

彻底卸载macOS上所有版本Python的详细指南

时间:2026-01-18 阅读:
目录

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

注意:macOS 自带的 Python 2.x 或 3.x 系统依赖它,请不要删除系统版本,否则可能导致 macOS 工具(如 xcode-selectbrewgit)异常。

卸载 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 "