当前位置：首页 > news >正文

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

news 来源：原创 2025/7/25 18:37:21

使用场景：

在默认情况下，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 环境的安装位置。