[Python] - pip命令之config命令介绍和使用案例（设置国内数据源，修改缓存目录等）_pip config

什么是pip？

pip是Python的包管理器，用于安装和管理Python软件包。它允许用户从Python Package Index(PyPI)下载和安装各种开源Python库和工具。

pypi.org

pip documentation v23.3.1 (pypa.io)

Getting Started - pip documentation v23.3.1

config命令介绍

“pip config” 命令用于配置 pip 工具的行为。

Configuration - pip documentation v23.3.1 (pypa.io)

关于“*.ini”里面的选项说明：

 [global] 和 [install]为section名，每个section下面，包含多个设置项。

global: 表示会对所有pip命令生效。

install：表示只会对pip的install子命令生效。

pip config - pip documentation v23.3.1 (pypa.io)

config命令专属选项中有--editor，--site， --user 和 --global 是四个。

-- editor：

用于“config edit”指定使用的编辑器。

--site:

这个选项指定了 pip 工具所在python环境所使用的源。默认情况下，pip 会从官方的 PyPI(Python Package Index)源中下载和安装包。如果你想要使用其他源，比如清华大学的镜像源，你可以设置 pip.conf 或 pip.ini 文件中的 index-url 选项为该源的 URL。例如：

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

--user:

这个选项指定了用户级别的 pip 配置文件的位置。当你使用 pip 安装 Python 包时，pip 会首先查找当前用户的主目录下的 pip.conf 文件。如果在该文件中找到了相应的配置选项，pip 就会使用这些配置选项。例如，你可以在 ~/.pip/pip.conf 或 ~/pip/pip.ini文件中添加以下内容来指定一个私有源：

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

--global:

这个选项与 site 类似，但它指定的是全局级别的 pip 配置文件的位置。当你使用 pip 安装 Python 包时，pip 会首先查找系统级的 pip.conf 或pip.ini文件。如果在该文件中找到了相应的配置选项，pip 就会使用这些配置选项。例如，你可以在 /etc/pip.conf或 C:\ProgramData\pip\pip.ini 文件中添加以下内容来指定一个全局源：

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

总之，这三个选项的主要区别在于它们指定的配置文件位置和作用范围。site 和 user 选项分别指定了当前python环境的配置文件和用户级别的配置文件，而 global 选项则指定了全局级别的配置文件，如果同一个配置项在三个级别的配置文件中都存在，优先级依次为--site，--user，--global

config命令使用案例

列出当前python环境的配置信息

# -v 参数 表示尽可能详细信息
pip -v config list

从这里我们可以看到，在windows下，环境配置分为global，user和site三种。

site：表示只pip所在的python环境起作用，user：对当前登录用户起作用，global：对所有环境python环境起作用。

通过set命令设置配置项的值

pip config set --user global.cache-dir d:\MyDev\pip_cache

这里的配置项的名称需要使用“.”来进行分割，比如global.cache-dir代表在global这个section添加一个名为cached-dir的项，如下图所示：

通过unset命令删除某个配置项

pip config unset --user global.cache-dir

使用notepad.exe来编辑pip.ini

# 编辑当前python环境级别的配置文件，如果不指定级别，那么默认为--site
pip config edit --site --editor C:\Windows\notepad.exe
# 编辑用户级别的配置文件
pip config edit --user --editor C:\Windows\notepad.exe
# 编辑全局级别的配置文件
pip config edit --global --editor C:\Windows\notepad.exe

设置国内数据源

PyPI是国外的服务器，国内访问速度会比较慢，国内有很多PyPI的镜像服务器，我们可以通过修改配置，让pip命令从国内的镜像库来下载相关的第三方依赖包。

把相关配置项设置为用户级别，这样不需要为每个python虚拟环境都设置一次。

常用国内镜像源：

清华：https://pypi.tuna.tsinghua.edu.cn/simple/
阿里云：http://mirrors.aliyun.com/pypi/simple/
中国科技大学：https://pypi.mirrors.ustc.edu.cn/simple/
华中科技大学：http://pypi.hustunique.com/simple/
上海交通大学：https://mirror.sjtu.edu.cn/pypi/web/simple/
豆瓣：http://pypi.douban.com/simple/
 
注: 新版ubuntu要求使用https源。

设置数据源的地址为国内镜像服务器（我这里用清华的）：

pip config set --user global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set --user install.trusted-host https://pypi.tuna.tsinghua.edu.cn

通过“pip config edit --user --editor C:\Windows\notepad.exe”查看，修改后的配置：

安装第三方库进行测试：

 下载速度还是非常快的。

详细列出pip所在的python环境的所有配置

通过“pip config debug”命令列出当前pip环境的所有设置项和环境变量：

修改pip安装包的缓存目录到非系统盘（比如D盘)

默认情况下，pip安装的库会缓存到系统盘（比如windows下是C:\Users\{UserName}\AppData\Local\pip\cache）

这样子可能会导致C盘空间快速耗尽，通常我们需要修改到一个非系统盘的路径下面： 

pip config set --user global.cache-dir d:\MyDev\pip_cache