如何清理Mac上多版本Python及库以优化VSCode兼容性？

一、清理多余Python版本 #

1. 先列出系统中所有Python可执行文件路径，明确要清理的目标：

   which -a python python3
   

   系统自带的/usr/bin/python3请勿删除，其余第三方安装的（如Anaconda、pyenv、旧brew版本）可按以下方式清理：

• Anaconda清理：直接删除Anaconda安装目录（默认路径为~/opt/anaconda3），再打开~/.zshrc（或~/.bash_profile），删除所有Anaconda相关的环境变量配置行（通常以export PATH="/Users/xxx/opt/anaconda3/bin:$PATH"开头）。
• pyenv清理：若通过brew安装，执行卸载命令：

  brew uninstall pyenv
  

  若为手动安装，删除~/.pyenv目录，同时删除shell配置文件中pyenv的初始化代码（如eval "$(pyenv init --path)"这类行）。
• 旧brew Python版本：查看brew已安装的Python包：

  brew list | grep python
  

  卸载不需要的版本（如python@3.10）：

  brew uninstall python@3.10
  

  保留你需要的python@3.11即可。
• 手动安装的Python：删除/Library/Frameworks/Python.framework目录（对应手动下载安装包的Python），同时删除/usr/local/bin或/opt/homebrew/bin中对应的python、pip软链接。

二、清理冗余Python库 #

• 确认当前使用的pip对应brew安装的Python：

  which pip3
  

  路径应为/opt/homebrew/bin/pip3（M1 brew默认路径）或/usr/local/bin/pip3（Intel Mac）。
• 列出已安装的库，按需卸载：

  pip3 list
  pip3 uninstall [package-name]
  

• 清理pip缓存的安装包：

  pip3 cache purge
  

• 删除其他环境的遗留库目录：比如Anaconda的~/opt/anaconda3/lib/python3.x/site-packages、pyenv的~/.pyenv/versions/*/lib/python*/site-packages，直接删除这些目录即可。

三、整理PATH环境变量 #

• 查看当前PATH内容：

  echo $PATH
  

• 打开shell配置文件（M1默认用zsh，编辑~/.zshrc；用bash则编辑~/.bash_profile），删除所有无用的Python相关PATH配置行，比如：
  • Anaconda的路径配置
  • pyenv的shims路径配置
  • 旧Python版本的手动添加路径
• 保存文件后，执行以下命令使修改生效：

  source ~/.zshrc
  

• 再次执行echo $PATH确认无用路径已移除，仅保留/opt/homebrew/bin（brew默认路径）和系统默认路径即可。

四、验证清理效果 #

• 确认当前Python版本：

  python3 --version
  

  应显示Python 3.11.3。
• 确认pip与Python版本对应：

  pip3 --version
  

• 在VSCode终端重复上述命令，确保环境一致，测试import pandas是否正常运行。

内容的提问来源于stack exchange，提问作者dev77cmd