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

作者:

文章目录
  • 自动检测并卸载所有非系统版本的 Python(包括官方安装包、Homebrew、Pyenv 等) 不会删除 macOS 自带的系统 Python(安全) 删除 pip 缓存、虚拟环境和 PATH 中的无效路径
  • 目录
    • 卸载 macOS 上所有版本的 Python
      • 查看已安装的 Python
      • 卸载通过官方安装包(.pkg/.dmg)安装的 Python
      • 卸载 Homebrew 安装的 Python
      • 删除用户环境中可能残留的配置
      • 检查系统是否还有 Python(保留系统版本)
      • (可选)清理 PATH 环境变量
      • 验证卸载结果
    • macOS Python 一键卸载脚本
      • 使用方法
        • 第一步:复制下面脚本到一个文件
        • 第二步:运行脚本
        • 第三步:验证是否干净

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

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

    先打开终端,执行:

    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
    

    如果是从 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 等)。

    如果曾用 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
    

    python3 --version
    which python3
    

    正常情况下,系统还会有一个 /usr/bin/python3(macOS 自带的安全版本)。

    编辑 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

    • 自动检测并卸载所有非系统版本的 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 ]; then
      echo "⚠️  请使用 sudo 运行此脚本:sudo bash ~/uninstall_python.sh"
      exit
    fi
    
    # 卸载 Homebrew 安装的 Python
    if command -v brew &>/dev/null; then
      echo "🍺 正在卸载 Homebrew Python..."
      brew uninstall --ignore-dependencies python python@3.9 python@3.10 python@3.11 python@3.12 2>/dev/null
      brew cleanup
    fi
    
    # 删除 python.org 安装包的 Python
    echo "🧾 正在删除官方安装包版本..."
    for v in 3.9 3.10 3.11 3.12 3.13; do
      sudo rm -rf /Library/Frameworks/Python.framework/Versions/$v
      sudo 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/"
    

    执行:

    sudo bash ~/uninstall_python.sh
    

    运行:

    which -a python3
    

    输出应只剩下:

    /usr/bin/python3

    到此这篇关于彻底卸载macOS上所有版本Python的详细指南的文章就介绍到这了,更多相关卸载macOS所有版本Python内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客!

    您可能感兴趣的文章:

    • macOS彻底卸载Python的超完整指南(推荐!)
    • 清晰易懂的Python彻底卸载与清理教程(附完整步骤)
    • Python UV安装、升级、卸载详细步骤记录
    • Python安装、卸载及环境配置全指南(解决常见问题与报错)
    • 如何将Python彻底卸载的三种方法
    • 详解如何使用pip卸载所有已安装的Python包
    • CentOS系统Python卸载攻略大揭秘
    • python完全卸载三种方法教程

    站内搜索