Python更改pip的默认安装位置的常用方法

一、前言

pip 是 Python 的包管理工具，用于安装和管理 Python 依赖包。

pip 默认会将依赖包安装到 Python 安装目录的 site-packages 中。

为了便于管理和减少C盘的空间占用，我们希望能够将 pip 下载的依赖包安装到自定义的目录。

[ 以下方案适用于 Windows 系统 ]

二、查看当前安装位置

打开命令提示符或 PowerShell 窗口，使用如下命令来查看当前 pip 的包安装位置

pip show pip

输出如下信息，Location 行显示了 pip 当前的包安装位置：

Name: pip
Version: 24.0
Summary: The PyPA recommended tool for installing Python packages.
Home-page:
Author:
Author-email: The pip developers <distutils-sig@python.org>
License: MIT
Location: C:\Users\用户名\AppData\Local\Programs\Python\Python311\Lib
Requires:
Required-by:

也可以使用 python -m site 查看 Python 的​​模块搜索路径系统​​和​​包安装位置​

python -m site

输出如下信息：

sys.path = [
    'C:\\Users\\用户名',                   # 当前工作目录
    'C:\\Python312\\python312.zip',        # Python 标准库（压缩包）
    'C:\\Python312\\DLLs',                 # 动态链接库目录
    'C:\\Python312\\lib',                  # 标准库目录
    'C:\\Python312',                       # Python 安装根目录
    'C:\\Python312\\lib\\site-packages',   # 系统级包安装目录
]
USER_BASE: 'C:\\Users\\用户名\\AppData\\Roaming\\Python' (exists)
USER_SITE: 'C:\\Users\\用户名\\AppData\\Roaming\\Python\\Python312\\site-packages' (exists)
ENABLE_USER_SITE: True

三、更改 pip 的默认包安装位置

方法 1：在安装 Python 时，使用自定义安装

在初次安装 Python 时，如果指定了安装盘符（例如E盘），那么 pip 的默认安装路径也会随之改变。pip 默认会将第三方包安装到 Python 安装目录下的 Lib\site-packages  文件夹中。

方法 2：使用 pip install 的 --target 或 --prefix 参数（每次安装时指定）

使用 pip install 命令的 --target 或 --prefix 参数，可以指定包安装的位置（临时指定），例如，我们希望将 pip 包安装到 E 盘。

# 每次安装时指定目标路径
pip install 包名 --target E:\你的自定义路径\Python\Python312\site-packages
 
# 或者使用--prefix参数
pip install 包名 --prefix E:\你的自定义路径\Python\Python312

这将会将依赖包安装到指定的目录下，而不是默认位置，但是这个方法只在当前的命令下有效。

注：使用虚拟环境的项目建议优先使用 --target 或 --prefix 参数，构建项目级隔离。

方法 3：使用 pip.ini 配置文件

在用户目录下（C:\Users\用户名\AppData）创建 pip 文件夹 和 pip.ini 配置文件

# 打开命令提示符或 PowerShell
mkdir %APPDATA%\pip
notepad %APPDATA%\pip\pip.ini

编辑 pip.ini 文件内容，这将覆盖默认的安装设置，使 pip 将依赖包安装到指定位置。

# 将路径替换为你想要的实际路径
[global]
target = E:\你的自定义路径\Python\Python312\site-packages
 
[install]
install-option = --prefix=E:\你的自定义路径\Python\Python312

方法 4：通过环境变量设置

右键 "此电脑" → 属性 → 高级系统 → 环境变量 → 新建环境变量

# 设置 PIP_TARGET 环境变量

变量名：PIP_TARGET 
变量值：E:\你的自定义路径\Python\Python312\site-packages

# 设置 PYTHONPATH 环境变量

变量名：PYTHONPATH
变量值：E:\你的自定义路径\Python\Python312\site-packages

# 设置 PYTHONUSERBASE 环境变量

变量名：PYTHONUSERBASE 
变量值：E:\你的自定义路径\Python

相关环境变量的说明及其关系

方法 5：修改 site.py 文件

查看 site.py 存放路径，site.py 一般存放在 Python 安装目录下的 Lib 目录，也可以使用命令查询

python -c "import site; print(site.__file__)"

打开 site.py 文件，编辑以下内容，修改为你的自定义路径：

修改前：

修改后：

注：如果设置了环境变量（无论值为何），Python 都会跳过用户级的 site-packages，即，如果环境变量的设置有效，就无需修改 site.py 文件。

四、验证设置

使用本文 第二点 列出的命令验证设置是否有效，如果输出行中出现了你刚才设置的安装路径，则代表设置成功。你可以尝试运行一个 Python 项目并使用 pip install 进一步验证。

注：如果之前已经使用 pip install 将依赖包安装到 site-packages 目录下，可以在修改完安装目录后直接将之前的 site-packages 目录剪切到新的目录下，无需重新下载依赖。

以上就是Python更改pip的默认安装位置的常用方法的详细内容，更多关于Python更改pip默认安装位置的资料请关注脚本之家其它相关文章！