本文详解如何安全、持久地将 pip 默认缓存目录（默认位于 c 盘）迁移至其他驱动器，避免 ai 项目频繁安装不同版本 pytorch/cuda 导致的磁盘空间耗尽问题，并提供配置文件路径确认、环境变量设置及缓存清理实操指南。
本文详解如何安全、持久地将 pip 默认缓存目录（默认位于 c 盘）迁移至其他驱动器，避免 ai 项目频繁安装不同版本 pytorch/cuda 导致的磁盘空间耗尽问题，并提供配置文件路径确认、环境变量设置及缓存清理实操指南。
在 Windows 系统中，pip 默认将下载的包缓存（如 .whl 文件、解压中间产物等）存储于用户目录下的 pip\Cache 路径中，具体位置为：
%LOCALAPPDATA%\pip\Cache
（即 C:\Users\<用户名>\AppData\Local\pip\Cache）。当您频繁克隆多个 AI 项目并安装不同 CUDA 版本的 PyTorch（如 torch-2.0.1+cu117、torch-2.3.0+cu121），每个变体都会被完整缓存，极易占用数十 GB 空间，严重挤压系统盘容量。
✅ 正确查找与配置 pip 配置文件（pip.ini）
许多教程误称 pip 配置文件位于 %HOME%\pip\pip.ini，但 Windows 下该路径并不存在。真实且标准的配置路径是：
%APPDATA%\pip\pip.ini
即 C:\Users\<用户名>\AppData\Roaming\pip\pip.ini（注意是 Roaming，非 Local 或 Home）。
若该目录或文件不存在，请手动创建：
- 在文件资源管理器地址栏输入 %APPDATA%\pip → 回车（若提示“找不到”，请先新建 pip 文件夹）；
- 在其中新建纯文本文件，命名为 pip.ini（确保扩展名不是 .txt）；
- 用记事本或 VS Code 打开，写入以下内容：
[global] cache-dir = D:\pip_cache
? D:\pip_cache 可替换为您目标磁盘的任意空文件夹（如 E:\Python\PipCache），请提前手动创建该目录。
? 修改后无需重启终端，新执行的 pip install 命令将立即使用新缓存路径。
✅ 替代方案：通过环境变量全局生效（推荐用于多用户/CI 场景）
若您希望配置对所有 shell（CMD、PowerShell、Git Bash）均生效，或需在脚本中统一控制，可设置系统级环境变量：
Windows GUI 设置：
系统属性 → 高级 → 环境变量 → 新建用户变量：
变量名：PIP_CACHE_DIR
变量值：D:\pip_cache-
PowerShell 临时设置（当前会话）：
$env:PIP_CACHE_DIR="D:\pip_cache"
-
CMD 临时设置：
set PIP_CACHE_DIR=D:\pip_cache
✅ 优先级说明：环境变量 PIP_CACHE_DIR > pip.ini 中的 cache-dir > 默认路径。任一方式生效即可，建议首选 pip.ini 方式，更清晰可控。
✅ 验证配置是否生效
运行以下命令检查当前缓存路径：
pip debug -v
在输出中查找 cache_dir 字段，确认其值已更新为您的目标路径（如 D:\pip_cache）。
也可直接查看缓存是否开始写入新位置：
pip install --no-deps --dry-run requests 2>&1 | findstr "Cache"
（该命令模拟安装并输出缓存操作路径）
⚠️ 重要注意事项
- 不要直接移动旧缓存文件夹！ pip 不支持“热迁移”。迁移前请先清空旧缓存（见下文），再启用新路径，否则可能因哈希冲突导致安装失败。
- 虚拟环境不能替代缓存迁移：虽然 python -m venv venv 可隔离包安装路径（site-packages），但 pip install 时仍会先从全局缓存解压，因此无法缓解 C 盘缓存膨胀问题。
-
pip purge 并非 pip 内置命令：原答案中提到的 pip purge 是错误信息 —— pip 官方不提供 purge 子命令。正确清理缓存方式为：
pip cache info # 查看当前缓存状态 pip cache info --verbose # 显示详细路径 pip cache remove "*" # 删除全部缓存（谨慎！） pip cache purge # ✅ 正确命令：彻底清空缓存（pip ≥ 20.1）
- 清理后首次安装会稍慢（需重新下载），但后续复用将完全走新磁盘，长期显著提升 C 盘健康度。
✅ 总结：三步完成迁移
| 步骤 | 操作 | 命令/路径 |
|---|---|---|
| ① 创建新缓存目录 | 手动新建目标文件夹 | mkdir D:\pip_cache |
| ② 配置 pip.ini | 编辑 %APPDATA%\pip\pip.ini | [global] cache-dir = D:\pip_cache |
| ③ 清理旧缓存 | 彻底释放 C 盘空间 | pip cache purge |
完成上述操作后，所有新 pip install 行为将自动使用您指定的磁盘路径，AI 工程师从此告别 “C 盘红色告警” —— 缓存有归属，开发更从容。
