如何修改pip全局缓存位置和全局安装包存放路径

使用场景：

在默认情况下，pip 会将安装的包存放在 Python 环境的 site-packages 目录下，会使用到系统盘的内存。
当遇到系统盘的内存很小的时候,需要修改pip的全局缓存位置和全局安装包存放路径,可以极大的节省系统盘内存

详细步骤：

---

1. 修改 pip 的全局缓存位置

pip 会默认将下载的文件存放在缓存目录中（如 Linux 的 ~/.cache/pip，Windows 的 %LOCALAPPDATA%\pip\Cache），如果你需要更改这个目录，可以通过设置环境变量 PIP_CACHE_DIR 实现。

在命令行中临时设置

例如，将缓存文件存放到 /my/custom/cache：

• Linux/macOS:

  export PIP_CACHE_DIR=/my/custom/cache
  

• Windows（CMD 命令行）:

  set PIP_CACHE_DIR=C:\my\custom\cache
  

• Windows（PowerShell）:

  $env:PIP_CACHE_DIR="C:\my\custom\cache"
  

全局设置

将上述环境变量添加到系统的环境变量中，以便在每次使用时都生效：

• Linux/macOS:
  编辑 ~/.bashrc 或 ~/.zshrc 文件，添加：

  export PIP_CACHE_DIR=/my/custom/cache
  

  然后运行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

• Windows:

  1. 按 Win + R，键入 sysdm.cpl 并点击 确定。
  2. 进入 高级 标签，点击 环境变量。
  3. 在系统变量或用户变量中，点击 新建，键入：
     • 变量名: PIP_CACHE_DIR
     • 变量值: C:\my\custom\cache
  4. 点击 确认 并重启终端。

---

2. 修改 pip 的全局安装目标位置

如果你希望更改全局的安装目标位置（即 site-packages 的存放目录），可以通过以下方法实现。

方法 1: 使用 --target 参数

这种方法是在每次安装时，手动指定目标位置。例如：

pip install <package-name> --target /my/custom/location

但是这样需要每次都手动指定，比较麻烦。

方法 2: 修改 pip 配置文件

pip 提供了一个配置文件，允许全局或用户级别的修改。可以通过编辑配置文件，设置安装目标位置。

• Linux/macOS:
  修改或创建 $HOME/.pip/pip.conf 文件，内容如下：

  [global]
  target = /my/custom/location
  

• Windows:
  修改或创建 %APPDATA%\pip\pip.ini 文件，内容如下：

  [global]
  target = C:\my\custom\location
  

方法 3: 配置环境变量

与上述全局缓存目录类似，你也可以通过 PYTHONUSERBASE 或配置 PIP_TARGET 环境变量来更改默认的安装位置：

• 临时改动：

  • Linux/macOS:

    export PIP_TARGET=/my/custom/location
    

  • Windows（CMD 命令行）:

    set PIP_TARGET=C:\my\custom\location
    

  • Windows（PowerShell）:

    $env:PIP_TARGET="C:\my\custom\location"
    

• 全局生效：
  按照上述方法，将 PIP_TARGET 的值写入到环境变量中。

---

3. 查询当前的 pip 缓存和配置路径

你可以运行以下命令查看当前的 pip 缓存路径和默认配置路径：

pip cache dir
pip config list

这些命令会显示 pip 的当前缓存目录和配置内容，以便确认是否生效。

---

4. 修改 pip 的其他配置项

pip 提供了多种方式来修改默认行为，你可以通过以下方式编辑全局或本地配置：

全局配置文件路径

• Linux/macOS: /etc/pip.conf
• Windows: %PROGRAMDATA%\pip\pip.ini

用户级配置文件路径

• Linux/macOS: $HOME/.pip/pip.conf
• Windows: %APPDATA%\pip\pip.ini

编辑配置文件

在配置文件中，添加类似的配置项：

[global]
cache-dir = /my/custom/cache
target = /my/custom/location

这样可以修改 pip 的默认行为，包括缓存位置和安装路径等。

---

通过以上方法，你可以灵活调整 pip 的缓存位置和安装目标位置。如果安装遇到权限问题，可以使用 --user 选项或更改 Python 环境的安装位置。