如何批量移除Python中pip安装的未使用包且不误删在用包？

一、用代码导入检测工具定位未使用包 #

这类工具会扫描项目Python文件，识别实际导入的包，对比已安装依赖，找出未被使用的部分：

• pip-check：安装后直接扫描项目，直观列出未使用包，支持交互式批量卸载

  pip install pip-check
  # 扫描并显示未使用包
  pip-check
  # 交互式卸载未使用包（会提示确认）
  pip-check --uninstall
  

• pipreqs：生成仅包含项目实际导入包的requirements.txt，和原文件对比就能找出差异

  pip install pipreqs
  # 生成项目依赖文件（替换成你的项目路径）
  pipreqs /your/project/path
  # 对比新旧requirements.txt，找出未使用的包（Linux/macOS用diff，Windows可手动对比）
  diff old_requirements.txt requirements.txt
  

• pycln：先清理代码中未使用的导入语句，再配合其他工具检测，结果更准确

  pip install pycln
  # 扫描并清理当前目录下所有Python文件的未使用导入
  pycln .
  

二、虚拟环境重建法（最稳妥，避免误删） #

如果担心工具误判，直接重建干净的虚拟环境是最可靠的方式：

1. 备份当前所有依赖：

   pip freeze > old_requirements.txt
   

2. 创建并激活新的虚拟环境：

   # 创建新环境
   python -m venv clean_env
   # Windows激活
   clean_env\Scripts\activate
   # Linux/macOS激活
   source clean_env/bin/activate
   

3. 用pipreqs生成项目真实需要的依赖，或者手动整理核心依赖，安装后测试项目：

   pip install -r new_requirements.txt
   

4. 运行项目的所有功能模块，确认没有报错。如果有缺失的依赖，手动安装并补充到新的requirements.txt里。
5. 确认没问题后，直接弃用旧环境，用新环境替代即可。

三、关键注意事项 #

• 操作前一定要备份原requirements.txt和虚拟环境，防止误操作导致项目崩溃。
• 部分工具可能把间接依赖（被其他包调用的依赖）识别为未使用，卸载前务必全面测试项目功能。
• 生成新依赖时要注意版本兼容性，尤其是原requirements.txt里有版本约束的包，避免因版本不匹配引发问题。

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