pip-autoremove只删除被标记为“非显式安装且未被任何保留包依赖”的包，不扫描代码、不读requirements.txt、不处理conda/pep517/手动安装包，也无法识别元数据损坏的“幽灵包”。
pip-autoremove 不是“一键清空无用包”的万能工具，它只删那些被明确标记为“非显式安装 + 未被任何保留包依赖”的包——而绝大多数人的环境根本没产生过这种标记。
pip-autoremove 到底删哪些包？看它怎么判断“冗余”
它不扫描代码、不读 requirements.txt、不检查 import 语句，只依赖 pip 当前的元数据快照做逆向推导：
- 你运行过
pip install flask→werkzeug和jinja2被记为 flask 的依赖，不删 - 你后来又单独运行过
pip install jinja2→jinja2变成“显式安装”，即使 flask 卸载了，它也不会被删 - 你用
pip install -e .装过本地包 → 它完全忽略，不进分析范围 - 你手动删过
site-packages里的文件但没走pip uninstall→ 元数据损坏，它跳过这些“幽灵包”，但它们还在占空间
为什么 pip-autoremove -y 执行完还剩一堆包？
这不是 bug，是设计使然。以下情况它直接失效：
- 项目用
poetry或pipenv管理依赖 → 它只看pip list输出，感知不到 lock 文件约束 - 环境是 conda 创建的 → 它对 conda 安装的包无效，且可能误删混装的 pip 包，导致环境崩溃
- 包通过
python setup.py install或pip install --find-links安装 →pip show缺失Requires-Dist字段，依赖链断裂 - 你删过
setuptools、wheel、pip自身 → 它可能把它们列为“可删”，但删了就失去包管理能力
真正靠谱的清理路径：别只靠 pip-autoremove
它适合小范围收尾，不能当主力。更实际的做法是组合使用：
- 先用
pipreqs ./ --force --savepath requirements_real.txt扫描真实import行为，生成最小依赖清单 - 对比
pip freeze > requirements_all.txt，用comm -23 找出未被 import 的包 - 人工过滤掉
pip、setuptools、wheel、pip-tools等关键包再批量卸载 - 如果环境已严重污染，直接
rm -rf venv+python -m venv venv+pip install -r requirements_real.txt更省心
最常被忽略的一点：pip-autoremove 在虚拟环境中运行时，默认会把 pip、setuptools、wheel 都列进候选列表。不加 -l 就直接 -y，等于主动废掉自己的包管理能力。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
