pip uninstall -r需配合pip freeze > requirements.txt生成带版本号的正确格式文件，否则报错；推荐重建虚拟环境替代卸载，更安全彻底。
直接用 pip uninstall -r 最省事，但必须先生成正确格式的列表文件
核心是：不能靠 pip list 的原始输出，得用 pip freeze 生成带版本号的、pip uninstall -r 能识别的格式。否则会报错 Invalid requirement 或跳过大量包。
执行这三步即可：
-
pip freeze > requirements.txt—— 注意不是pip list > requirements.txt，后者含表头和对齐空格，uninstall -r无法解析 -
pip uninstall -r requirements.txt -y——-y自动确认，避免中途卡住 -
del requirements.txt（Windows）或rm requirements.txt（macOS/Linux）—— 清理临时文件
⚠️ 如果 requirements.txt 里出现 pkg @ file://... 这类本地路径安装项，pip uninstall -r 会失败；此时需手动删掉这些行再重试。
用 pip list --format=json 获取干净包名列表（适合写脚本或过滤系统包）
当你需要跳过 pip、setuptools、wheel 等基础包时，pip freeze 不够安全——它不区分用户安装和环境预装包。更可靠的方式是用 JSON 输出解析包来源。
推荐命令：
-
pip list --format=json --local——--local排除全局/系统级包，只返回当前环境（如虚拟环境）中用户安装的部分 - 配合 Python 脚本提取包名：
python -c "import json, sys; print('\n'.join(pkg['name'] for pkg in json.load(sys.stdin) if pkg['name'].lower() not in {'pip', 'setuptools', 'wheel', 'importlib-metadata', 'distlib'}))" < <(pip list --format=json --local)
这个组合能避开绝大多数误删风险，尤其适合 CI/CD 中自动化清理。
使用位于 ci-tools.xrow.de 的 CI Tools 组件目录构建和维护 GitLab CI/CD 流水线，适用于创建或修复 .gitlab-ci.yml 文件，选择合适的组件。
Windows 下别用 for /f 直接读 pip freeze 输出
很多教程教你在 CMD 里写：for /f %i in ('pip freeze') do pip uninstall -y %i，这会出问题：
-
pip freeze输出含==和@符号（如requests==2.31.0或numpy@file:///...），CMD 的for /f默认按空格分割，导致包名被截断 - 遇到带空格的路径或特殊字符时直接崩溃
- 没有错误捕获，某个包卸载失败就中断，后续包全剩着
真要用命令行循环，改用 PowerShell 更稳：pip freeze | ForEach-Object { $_ -split '==|@' | Select-Object -First 1 } | ForEach-Object { pip uninstall -y $_ }，但依然不如 -r 方式可靠。
最安全的「批量卸载」其实是重建虚拟环境
所有基于 pip uninstall 的方案都有隐性风险：依赖关系未被完整追踪，某些包卸载后残留 .dist-info 目录或.pth 文件，下次 pip install 可能行为异常。
真正一劳永逸的做法是：
- 先退出当前环境：
deactivate - 删掉整个虚拟环境目录（如
rm -rf venv或rmdir /s venv） - 重新创建：
python -m venv venv
这比“卸载所有包”更快、更彻底，且完全规避了 ModuleNotFoundError: No module named 'pip._internal' 这类因误删 pip 自身导致的灾难性错误——毕竟，没人会去卸载一个根本不存在的东西。
