mac 完全卸载卸载 python

245 阅读2分钟

在 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 等。

A. 卸载 Homebrew 安装的 Python

  1. 卸载 Python 包

    brew uninstall python@3.x  # 替换为实际版本,如 python@3.11
    brew cleanup -s python@3.x  # 清理残留
    
  2. 删除符号链接(如果存在):

    sudo rm /usr/local/bin/python3
    sudo rm /usr/local/bin/pip3
    

B. 卸载官方 pkg 安装的 Python

  1. 删除框架目录

    sudo rm -rf /Library/Frameworks/Python.framework/Versions/x.x  # 替换版本号
    
  2. 删除应用目录

    sudo rm -rf "/Applications/Python x.x"  # 版本号含空格,需加引号
    
  3. 删除可执行文件和符号链接

    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
    

  1. 删除用户目录下的配置和缓存

    rm -rf ~/Library/Python/x.x  # 用户级包
    rm -rf ~/.local/bin/pip3
    rm -rf ~/.cache/pip
    rm -rf ~/.pyenv
    
  2. 清理环境变量

    • 编辑 ~/.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,仅处理用户安装的版本,以避免系统异常。