pip cache purge 是唯一推荐的清理方式,它原子性清空缓存内容但保留目录结构,避免 OSError;支持按包名精准清理(如 pip cache purge torch),且须用 pip cache dir 获取真实缓存路径。

pip cache purge 是唯一推荐的清理方式
直接删缓存文件夹(比如 %LocalAppData%\pip\Cache 或 ~/.cache/pip)看似快,但容易触发 OSError: [Errno 2] No such file or directory,尤其在 Windows 下 pip 可能正往里写临时文件。而 pip cache purge 是原子操作,清空内容但保留目录结构,避免后续 pip install 报错。
执行前确认 pip 版本不低于 20.1(2026 年所有主流环境都满足),命令会输出释放了多少空间,例如:
Files removed: 892<br>Cache size: 0 B
- 该命令不影响已安装的包、虚拟环境或项目代码
- 下次安装曾缓存过的包时,会重新下载并缓存——仅此而已
- 不建议搭配
rm -rf或资源管理器手动删除,风险远大于收益
想只清某个包的缓存?用 pip cache purge
当你反复测试 torch 不同 CUDA 版本(如 torch-2.3.0+cu121 和 torch-2.0.1+cu117),又不想清掉其他常用包(numpy、requests)的缓存,可以精准清理:
pip cache purge torch
注意: 必须和 pip show torch 显示的 Name 字段完全一致,大小写敏感,不支持模糊匹配或通配符。
- 该命令只删匹配到的 wheel 或源码包,不会动其他包的缓存
- 如果包名拼错,命令静默成功但实际没删任何东西
- 无法按版本号过滤(比如只删
torch==2.0.1),pip cache list也不显示版本,只能全删或不删
缓存位置查不到?用 pip cache dir 而不是猜路径
不同系统默认路径不同,硬记容易出错:Windows 是 %LocalAppData%\pip\Cache,macOS 是 ~/Library/Caches/pip,Linux 是 ~/.cache/pip。但这些路径可能被自定义覆盖——比如你设过 PIP_CACHE_DIR 环境变量,或改过 pip.ini 配置。
最可靠的方式是运行:
pip cache dir
它会输出当前生效的真实路径,比如:
D:\pip_cache
- 这个输出结果才是你真正该关注的位置,别信“教程说的默认路径”
- 如果返回空或报错,说明 pip 版本太老(pip install --upgrade pip
- 路径中含空格或中文一般不影响,但某些旧版 PowerShell 可能解析失败,换用 CMD 或 Git Bash 更稳
缓存占 C 盘太多?迁移到其他盘比清理更治本
频繁清理只是止痛,尤其在 AI 开发中装一堆 torch/tensorflow 变体,缓存几天就涨回 20GB。与其反复 purge,不如一劳永逸迁走:
Windows 用户优先设环境变量:PIP_CACHE_DIR=D:\pip_cache(需提前创建该文件夹),比改 pip.ini 更可靠,且对 CMD/PowerShell/Git Bash 全局生效。
- 迁移后首次运行
pip install会自动在新路径建结构,旧缓存仍留着,记得手动pip cache purge一次 - 迁移不改变任何已有环境行为,所有虚拟环境、IDE 集成都无感适配
- 千万别把缓存设到网络盘或移动硬盘,pip 写缓存是高频小文件 I/O,会卡死安装过程
真正麻烦的从来不是“怎么删”,而是删完两天又满——缓存机制本身没变,问题还在。迁路径 + 定期 pip cache purge 组合,才能让磁盘空间长期可控。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











