Mac M1 Ventura下误全局安装pip包的清理与后续处理

先明确当前Python版本情况 #

你可能同时安装了Homebrew和官网版Python，先搞清楚当前在用的是哪套：

• 查看Python路径：which python3
  • Homebrew安装的Python通常路径是/opt/homebrew/bin/python3
  • 官网安装的Python路径一般是/Library/Frameworks/Python.framework/Versions/3.x/bin/python3
• 查看对应pip路径：which pip3，确保pip和Python是配套的（pip3路径应与python3路径在同一目录下）
• 查看版本信息：python3 --version、pip3 --version，确认每个安装的Python版本及其对应的pip

1. 清理全局pip包 #

步骤： #

1. 备份当前全局包列表（可选但推荐）：

   pip3 freeze > global-packages-backup.txt
   

   这个文件会保存所有已安装的全局包及其版本，之后需要恢复时可执行pip3 install -r global-packages-backup.txt。

2. 批量卸载所有全局包：

   pip3 freeze | xargs pip3 uninstall -y
   

   该命令会自动卸载所有通过pip3全局安装的包。如果有个别不想卸载的包，先打开global-packages-backup.txt删除对应行，再用修改后的文件反向过滤：

   pip3 freeze | grep -v -f keep-packages.txt | xargs pip3 uninstall -y
   

   （keep-packages.txt需手动创建，每行填写一个要保留的包名）

3. 针对多Python版本的清理：
   如果确认有多个Python安装，需对每个版本单独执行上述命令，比如处理Homebrew的Python：

   /opt/homebrew/bin/pip3 freeze > brew-global-packages.txt
   /opt/homebrew/bin/pip3 freeze | xargs /opt/homebrew/bin/pip3 uninstall -y
   

   处理官网Python同理，替换成对应的pip路径即可。

2. 能否保留全局包继续使用？ #

可以保留，但不推荐作为长期方案：

• 风险：全局包版本固定，当不同项目依赖同一个包的不同版本时，会出现版本冲突，导致项目运行报错。
• 临时妥协方案：如果某些包体积大、安装耗时，可在创建虚拟环境时让它继承全局包：

  mkvirtualenv --system-site-packages your-project-env
  

  但这种方式会让虚拟环境失去隔离性，后续仍建议把项目依赖的包单独装在虚拟环境里，逐步移除对全局包的依赖。

内容的提问来源于stack exchange，提问作者Climate Tech Handbook