Python 安装路径和 pip 缓存路径有什么关系？

为什么把 Python 安装在 D 盘，C 盘空间还是会在安装包时变小？

不少人在安装 Python 时特地把目标目录改到了 D:\Python312，但后续在安装 PyTorch、TensorFlow 或 Pandas 等体积较大的第三方库时，发现 C 盘可用空间依然明显减少。这是因为 Python 运行环境和 pip 下载缓存采用两套不同的路径决定机制，分别服务于不同的职责。

Python 安装路径由你在安装解释器或创建虚拟环境时指定的路径决定。它负责存放 Python 可执行文件（python.exe 或 python3）、标准库，以及位于 Lib\site-packages（Linux/macOS 为 lib/pythonX.Y/site-packages）中已经解压并可直接导入运行的第三方包代码。

pip 缓存路径则由操作系统分配给当前登录用户的本地缓存环境变量决定，与 Python 解释器装在哪个分区没有从属关系。它负责存放 pip 从镜像源下载时的 HTTP 缓存文件，以及编译打包好的 .whl（Wheel）归档文件。这样做的目的是当你在同一台机器上再次安装相同版本的包时，直接复用本地归档，省去重新下载和源码编译的时间。

安装一个第三方包时，这两个路径之间到底发生了什么？

理解了两个路径各自的位置后，下一个自然的问题是：既然最终运行代码只需要 site-packages 里的文件，为什么 pip 还要先经过缓存路径？

当你运行 python -m pip install numpy 时，当前 Python 安装路径下的 pip 模块会按固定顺序与 pip 缓存路径配合完成安装：

1. 确定目标环境：通过你调用的 python 解释器位置，确定最终要把包安装到哪个 Python 安装路径（或虚拟环境）的 site-packages 目录中。
2. 检索本地 pip 缓存：pip 前往当前用户的 pip 缓存路径，检查 wheels 子目录中是否已经存在兼容当前 Python 版本（如 cp312）和操作系统架构（如 win_amd64）的 .whl 文件。
3. 下载或构建并写入缓存：如果本地缓存已命中，pip 直接跳过下载（终端会提示 Using cached ...）；如果未命中，pip 从 PyPI 或镜像源下载文件，将网络响应存入缓存目录的 http-v2 中。若下载的是源码包（.tar.gz），pip 还会先在本地构建成 .whl 文件并存入缓存目录的 wheels 文件夹。
4. 解压安装到 Python 安装路径：pip 将缓存中的 .whl 文件（本质是标准 ZIP 格式）解压，把里面的模块文件夹和版本信息复制到目标 Python 安装路径的 Lib\site-packages 下。

这也解释了为什么安装一个 300 MB 的包，有时总共会消耗 600 MB 以上的磁盘空间：pip 缓存路径里保留了一份约 300 MB 的压缩包副本（通常在 C 盘），而 Python 安装路径的 site-packages 里又存放了一份解压后的文件（在你安装 Python 的磁盘）。

如何查看当前的 Python 安装路径和 pip 缓存路径？

在调整或清理路径之前，建议先在终端（Windows 打开 PowerShell 或 CMD，macOS/Linux 打开 Terminal）中使用命令行核对当前环境对应的两个真实路径。使用 python -m pip 而不是单独输入 pip，可以确保你查询的 pip 与当前调用的 Python 解释器严格对应。

1. 查看当前 Python 安装路径与包安装位置

在终端中执行以下命令，输出当前 Python 环境的根目录以及第三方库所在的 site-packages 路径：

python -c "import sys, site; print('Python安装路径:', sys.prefix); print('第三方包路径:', site.getsitepackages())"

Python安装路径: D:\Python312
第三方包路径: ['D:\\Python312', 'D:\\Python312\\Lib\\site-packages']

2. 查看当前 pip 缓存路径与占用空间

接着执行 pip cache dir 和 pip cache info，查看 pip 缓存实际落在哪个目录以及占用了多少磁盘空间：

python -m pip cache dir
python -m pip cache info

C:\Users\DevUser\AppData\Local\pip\Cache
Package index page cache location (pip v23.3+): C:\Users\DevUser\AppData\Local\pip\Cache\http-v2
Package index page cache location (older pips): C:\Users\DevUser\AppData\Local\pip\Cache\http
Package index page cache size: 412.6 MB
Number of HTTP files: 184
Locally built wheels location: C:\Users\DevUser\AppData\Local\pip\Cache\wheels
Locally built wheels size: 85.2 MB
Number of locally built wheels: 19

对比上面两段输出可以直观看到：即便 Python 安装路径位于 D:\Python312，pip 的缓存目录依然位于 C:\Users\DevUser\AppData\Local\pip\Cache。

如何把 pip 缓存路径迁移到其他磁盘或目录？

如果你希望让 pip 缓存路径也跟随 Python 一起放到 D 盘或其他大容量分区，不需要重装 Python，只需通过 pip config 修改全局配置即可。按下面 4 个步骤操作即可完成迁移：

步骤 1：准备目标文件夹并修改 pip 全局配置

假设你要将 pip 缓存路径改到 D:\pip_cache（Linux/macOS 可改为如 /data/pip_cache），在终端中直接运行：

python -m pip config set global.cache-dir "D:\pip_cache"

Writing to C:\Users\DevUser\AppData\Roaming\pip\pip.ini

这条命令会自动在当前用户的 pip 配置目录中生成或更新 pip.ini（Linux/macOS 为 pip.conf），写入 cache-dir = D:\pip_cache。

步骤 2：验证新的 pip 缓存路径是否生效

修改完成后，再次运行路径查询命令确认结果：

python -m pip cache dir

D:\pip_cache

步骤 3：清理或移动旧路径下的历史缓存

修改 global.cache-dir 只会让今后的缓存写入新目录，不会自动删除或搬移旧目录里的已有文件。你可以根据需求二选一：

• 想直接释放 C 盘空间：如果此前还没有修改配置，可以先运行 python -m pip cache purge 清空缓存，再执行步骤 1 的修改命令；如果已经修改了配置，直接在文件资源管理器中打开原先的 C:\Users\<用户名>\AppData\Local\pip\Cache，将其中的 http-v2 和 wheels 文件夹删除即可。
• 想保留历史缓存免去重下：将原 Cache 目录下的全部子文件夹剪切粘贴到新的 D:\pip_cache 目录中。

多版本 Python、虚拟环境或卸载 Python 时，这两个路径会互相影响吗？

在实际开发中，一台电脑上往往不止一个 Python 环境。围绕多环境共存和卸载重装，这两个路径的关系可以归纳为以下三个常见场景：

1. 多个 Python 版本或虚拟环境，默认共用同一个 pip 缓存路径

如果你在电脑上同时安装了 D:\Python311、D:\Python312，并且为不同项目创建了多个 venv 虚拟环境，它们的Python 环境路径（及各自的 site-packages）是完全隔离的，但它们的pip 缓存路径默认指向同一个用户级目录。

这种“多环境共享同一缓存池”的设计非常实用：当你在项目 A 的虚拟环境中通过 pip install requests 下载过一次包后，切换到项目 B 的虚拟环境再次安装相同版本的 requests 时，pip 会直接从共享的 pip 缓存路径中读取现成的 .whl 文件并解压到项目 B 的 site-packages，无需二次下载。同时，pip 会在缓存中按文件名区分 Python 版本和平台标签（例如 numpy-1.26.4-cp311-...whl 与 numpy-1.26.4-cp312-...whl），因此不同版本共享缓存目录也不会发生二进制冲突。

2. 卸载或删除 Python 安装路径，不会自动清除 pip 缓存

当你通过系统卸载程序卸载 Python，或者直接删除某个虚拟环境文件夹时，被清理的只有该 Python 安装路径及其内部的 site-packages。位于用户目录或自定义目录下的 pip 缓存依然保留在磁盘上。如果你重装同版本的 Python，这些留存的缓存还能加快恢复环境的速度；如果确认不再使用 Python，则需要手动删除 pip 缓存文件夹才能彻底回收磁盘空间。

3. 临时不需要缓存时，可以在单次安装中绕过 pip 缓存路径

在制作体积敏感的容器镜像（如 Docker 镜像）或磁盘剩余空间极小、无法同时容纳“缓存副本 + 解压后文件”时，可以在安装命令后加上 --no-cache-dir 参数：

python -m pip install --no-cache-dir torch

加上该参数后，pip 下载完临时文件并解压到 Python 安装路径的 site-packages 后会立即销毁临时文件，不在 pip 缓存路径中留下副本。