Pip配置国内镜像源加速-Windows Ubuntu等全平台通用(2021.1.16)

Pip配置国内镜像源加速（2021.1.16）

Pip 是使用 Python 必不可少的包管理工具，但是在使用默认源下载包的时候，经常出现因为网络问题导致超时的情况，因此有必要使用国内镜像源进行下载加速。

1. 国内镜像源

目前常用的镜像源有清华源、阿里源等：

• 清华源：https://pypi.tuna.tsinghua.edu.cn/simple；
• 阿里源：https://mirrors.aliyun.com/pypi/simple；

2. 演示环境

不同环境下相关命令可能需要进行一些调整，本文编写时所处的环境如下：

• Ubuntu 20.04；
• Python 3.8.5；
• Pip 20.0.2(>=10.0.0)；

3. 配置过程

关于 Pip 配置国内镜像源进行加速的文章，之前已经有很多前辈写过了，基本都是手动创建 Pip 的配置文件进行修改。对于该方法有一点弊端，即在 Linux 与 Windows 环境下 Pip 配置文件的位置和名称都有所不同，容易混淆，所以本文介绍一种通用的方法，想法来源于清华大学开源软件镜像站 pypi 镜像的使用帮助。

3.1 升级 Pip 版本

因为该方法需要 Pip 版本大于等于 10.0.0，所以需要先升级 Pip 到 10.0.0 以上，如果 Pip已经是最新版，此步可跳过；

# 升级 Pip 版本
$ python3 -m pip install --upgrade pip

# 查看 Pip 版本
$ pip3 --version

3.2 配置国内镜像源

个人感觉阿里源更加稳定，此处也以阿里源为例进行演示；

# 配置 Pip 阿里镜像源，--user参数表示当前用户生效
$ pip3 config set global.index-url https://mirrors.aliyun.com/pypi/simple --user
$ pip3 config set install.trusted-host mirrors.aliyun.com --user

3.3 查看是否成功

# 查看 Pip 所有配置项
$ pip3 config list --user
# 看到以下字段表示配置成功
global.index-url='https://mirrors.aliyun.com/pypi/simple/'
install.trusted-host='mirrors.aliyun.com'

3.4 其他操作

有关 pip3 config 详细的参数说明可以通过 pip3 config --help 命令查看其帮助文档，下面只是列出一些可能会用到的操作：

# 查看配置项及配置文件路径
$ pip3 config list -v
For variant 'global', will try loading '/etc/xdg/pip/pip.conf'
For variant 'user', will try loading '/home/xxx/.pip/pip.conf'
For variant 'user', will try loading '/home/xxx/.config/pip/pip.conf'
For variant 'site', will try loading '/usr/pip.conf'
global.index-url='https://mirrors.aliyun.com/pypi/simple/'
install.trusted-host='mirrors.aliyun.com'

# 在编辑器中打开配置文件，--editor参数指定使用的编辑器
$ pip3 config edit --editor vim --user

# 查看某项配置的值
$ pip3 config get global.index-url --user
https://mirrors.aliyun.com/pypi/simple

# 删除某项配置
$ pip3 config unset global.index-url --user
Writing to /home/xxx/.config/pip/pip.conf