使用场景:
在默认情况下,pip
会将安装的包存放在 Python 环境的 site-packages
目录下,会使用到系统盘的内存。
当遇到系统盘的内存很小的时候,需要修改pip的全局缓存位置和全局安装包存放路径,可以极大的节省系统盘内存
详细步骤:
1. 修改 pip
的全局缓存位置
pip
会默认将下载的文件存放在缓存目录中(如 Linux 的 ~/.cache/pip
,Windows 的 %LOCALAPPDATA%\pip\Cache
),如果你需要更改这个目录,可以通过设置环境变量 PIP_CACHE_DIR
实现。
在命令行中临时设置
例如,将缓存文件存放到 /my/custom/cache
:
-
Linux/macOS:
bashexport PIP_CACHE_DIR=/my/custom/cache
-
Windows(CMD 命令行):
cmdset PIP_CACHE_DIR=C:\my\custom\cache
-
Windows(PowerShell):
powershell$env:PIP_CACHE_DIR="C:\my\custom\cache"
全局设置
将上述环境变量添加到系统的环境变量中,以便在每次使用时都生效:
-
Linux/macOS:
编辑
~/.bashrc
或~/.zshrc
文件,添加:bashexport PIP_CACHE_DIR=/my/custom/cache
然后运行
source ~/.bashrc
或source ~/.zshrc
使配置生效。 -
Windows:
- 按
Win + R
,键入sysdm.cpl
并点击 确定。 - 进入 高级 标签,点击 环境变量。
- 在系统变量或用户变量中,点击 新建 ,键入:
- 变量名:
PIP_CACHE_DIR
- 变量值:
C:\my\custom\cache
- 变量名:
- 点击 确认 并重启终端。
- 按
2. 修改 pip
的全局安装目标位置
如果你希望更改全局的安装目标位置(即 site-packages
的存放目录),可以通过以下方法实现。
方法 1: 使用 --target
参数
这种方法是在每次安装时,手动指定目标位置。例如:
bash
pip install <package-name> --target /my/custom/location
但是这样需要每次都手动指定,比较麻烦。
方法 2: 修改 pip
配置文件
pip
提供了一个配置文件,允许全局或用户级别的修改。可以通过编辑配置文件,设置安装目标位置。
-
Linux/macOS:
修改或创建$HOME/.pip/pip.conf
文件,内容如下:ini[global] target = /my/custom/location
-
Windows:
修改或创建%APPDATA%\pip\pip.ini
文件,内容如下:ini[global] target = C:\my\custom\location
方法 3: 配置环境变量
与上述全局缓存目录类似,你也可以通过 PYTHONUSERBASE
或配置 PIP_TARGET
环境变量来更改默认的安装位置:
-
临时改动:
-
Linux/macOS:
bashexport PIP_TARGET=/my/custom/location
-
Windows(CMD 命令行):
cmdset PIP_TARGET=C:\my\custom\location
-
Windows(PowerShell):
powershell$env:PIP_TARGET="C:\my\custom\location"
-
-
全局生效:
按照上述方法,将
PIP_TARGET
的值写入到环境变量中。
3. 查询当前的 pip 缓存和配置路径
你可以运行以下命令查看当前的 pip
缓存路径和默认配置路径:
bash
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
编辑配置文件
在配置文件中,添加类似的配置项:
ini
[global]
cache-dir = /my/custom/cache
target = /my/custom/location
这样可以修改 pip
的默认行为,包括缓存位置和安装路径等。
通过以上方法,你可以灵活调整 pip
的缓存位置和安装目标位置。如果安装遇到权限问题,可以使用 --user
选项或更改 Python 环境的安装位置。