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

目录

• 一、前言
• 二、查看当前安装位置
• 三、更改 pip 的默认包安装位置
• 方法 1：在安装 Python 时，使用自定义安装
• 方法 2：使用 pip install 的 –target 或 –prefix 参数（每次安装时指定）
• 方法 3：使用 pip.ini 配置文件
• 方法 4：通过环境变量设置
• 方法 5：修改 site.py 文件
• 四、验证设置

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用户名AppDataLocalProgramsPythonPython311Lib
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

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

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

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

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

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

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

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

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

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

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

# 设置 PIP_TARGET 环境变量

变量名：PIP_TARGET 
变量值：E:你的自定义路径PythonPython312site-packages

# 设置 PYTHONPATH 环境变量

变量名：PYTHONPATH
变量值：E:你的自定义路径PythonPython312site-packages

# 设置 PYTHONUSERBASE 环境变量

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

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

变量名	作用范围	优先级	典型用途
PYTHONUSERBASE	用户级安装 (--user)	中	无权限时的包安装
PIP_TARGET	全局 pip 安装	低	修改所有pip安装路径
VIRTUAL_ENV	虚拟环境	最高	项目级完全隔离
PYTHONPATH	模块搜索路径	自定义	添加额外导入路径

查看 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默认安装位置的资料请关注风君子博客其它相关文章！

您可能感兴趣的文章:

• Python如何在ubuntu中更改Python和pip指向
• Python更改pip镜像源的方法示例
• 更改Python的pip install 默认安装依赖路径方法详解