pip 常用命令及配置

一、python -m pip install 和 pip install 的区别

在讲解 pip 的命令之前，我们有必要了解一下 python -m pip install 和 pip install 的区别，以便于我们在不同的场景使用不同的方式。

python -m pip install 命令使用 python 可执行文件将 pip 模块作为脚本运行。-m 选项代表模块，它告诉 python 运行指定的模块作为脚本。这允许您指定要使用的 python 解释器，即使您的系统上安装了多个版本的 python。
pip install 命令假定 pip 在系统的 PATH 中，并且对应您要使用的正确版本的 python。这种方式更加方便，它不需要您指定 python 解释器。但是，如果您安装了多个版本的 python ，或者 pip 可执行文件不在 PATH 中，那么 pip install 可能不会如预期的那样工作。
综上所述，python -m pip install 和 pip install 的效果是一样的，但是 python -m pip install 更灵活，pip install 更方便。

二、pip 常用命令

这里我省略了 python -m，根据不同场景可以加上。

2.1.安装模块包

bash 复制代码

# 最新版本
pip install package

# 指定版本
pip install package==1.0.4

# 最小版本
pip install package>=1.0.4

2.2.升级现有模块包

bash 复制代码

# 最新版本
pip install --upgrade package

# 最小版本
pip install --upgrade package>=1.0.4

2.3.只为当前用户安装模块包

bash 复制代码

pip install --user package

2.4.显示版本和路径

bash 复制代码

pip --version

2.5.获取帮助

bash 复制代码

pip --help

2.6.升级 pip

bash 复制代码

pip install -U pip

2.7.卸载模块包

bash 复制代码

pip uninstall package

2.8.搜索模块包

bash 复制代码

pip search package

但是现在使用 pip search package 会有 bug，会报下面的错，现在都使用 pip_search 模块进行搜索。

bash 复制代码

pip install pip-search

pip_search package

2.9.显示已安装模块包的详细信息

bash 复制代码

pip show package

2.10.列出已安装的模块包

bash 复制代码

pip list

2.11.查看可升级的模块包

bash 复制代码

pip list -o

2.12.导出 requirements.txt

bash 复制代码

pip freeze > requirements.txt

2.13.安装 requirements.txt 中指定的模块包

bash 复制代码

pip install -r requirements.txt

2.14.从其他索引安装模块包

bash 复制代码

pip install --index-url http://my.package.repo/simple/ package

2.15.除 pip 配置文件中 --index-url 指定的索引外，在安装过程中搜索其他索引

bash 复制代码

pip install --extra-index-url http://my.package.repo/simple package

2.16.下载模块包

bash 复制代码

pip download -d /path/pip_download package

pip download -d /path/pip_download -r requirements.txt

2.17 pip 设置、查看、修改、删除配置项

基本语法

bash 复制代码

pip config [-v] [--global | --user | --system] <command> [options]

bash 复制代码

# 设置配置项：设置全局镜像源（清华源）
pip config --global set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 查看所有配置
pip config list

# 获取指定配置项
pip config get global.index-url

# 删除指定配置项
pip config unset global.index-url

# 显示配置文件路径和环境变量
pip config debug

三、pip 常用配置

3.1.pip 的配置文件位置

pip 配置文件分为三个层级：全局、用户和虚拟环境级别。每个层级的配置文件适用于不同的范围，优先级依次为虚拟环境 > 用户 > 全局。

配置文件层级	配置文件位置	适用范围
全局配置	/etc/pip.conf	系统范围，适用于所有用户
用户配置	~/.pip/pip.conf	当前用户范围
虚拟环境配置	<virtual_env>/pip.conf	仅在虚拟环境中有效

3.2.pip 配置文件的格式

pip 配置文件使用 INI 文件格式。以下是一个简单的配置文件示例。

bash 复制代码

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
timeout = 60

[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

3.3.pip 常用配置项

下面的所有配置都可以通过 pip config 命令进行配置，配置完会显示配置文件所在位置。

3.3.1设置镜像源

pip 默认从官方 PyPI 源下载包，但在国内使用时，访问速度较慢。通过配置镜像源，可以显著提高安装速度。常用的镜像源包括：

清华大学镜像：https://pypi.tuna.tsinghua.edu.cn/simple
阿里云镜像：https://mirrors.aliyun.com/pypi/simple/
华为云镜像：https://mirrors.huaweicloud.com/repository/pypi/simple/
豆瓣镜像：https://pypi.douban.com/simple/

bash 复制代码

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
extra-index-url = https://mirrors.aliyun.com/pypi/simple/
                https://mirrors.huaweicloud.com/repository/pypi/simple/
                https://pypi.douban.com/simple/

3.3.2.配置超时时间

bash 复制代码

[global]
timeout = 60  # 以秒为单位，设置超时时间

3.3.3.配置下载缓存

pip 会缓存下载的包，以避免重复下载。

bash 复制代码

[global]
cache-dir = /path/to/cache  # 设置缓存目录

3.3.4.配置模块包安装路径

默认情况下，pip 会将包安装到当前环境的 site-packages 目录。如果你希望将包安装到其他路径，可以使用 target 配置项。

bash 复制代码

[global]
target = /path/to/custom/directory

四、参考链接

【Pip】完整的 `pip` 配置文件详解：优化你的包管理与环境设置_pip配置-CSDN博客