Python 更改 pip 下载源

0. 问题简述

使用 pip 安装 Python 包时默认会从官方的 PyPI （Python Package Index，Python包索引）源下载文件，由于官方下载源在国外，速度比较慢。国内的一些公司和机构提供了 PyPI 镜像源，可以修改 pip 索引源为国内的镜像源，以提高下载速度。

修改的原理都是更改 pip 配置文件的内容。pip 工具允许用户通过配置文件来设定一系列默认行为，包括但不限于包的安装源（index-url），信任的主机（trusted-host）等。以下是不同系统的更改方法，示例为阿里镜像源：

1. 暂时更改下载源

如果仅在本次下载中暂时更改下载源，直接在下载命令中通过 -i 参数指定下载源即可，其格式如下：

pip install SomePackage -i https://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com

2. 全局更改下载源

方法一，手动修改配置文件：

即手动在系统中找到配置文件并修改下载源，以下地址是配置文件在不同系统中的位置，如果不存在则需要创建该目录和文件：

# Windows系统：
%APPDATA%\pip\pip.ini

# Linux、MacOS系统：
$HOME/.config/pip/pip.conf
# pip较早的版本可能在：
$HOME/.pip/pip.conf

通过以上路径找到并打开 pip 文件后，在文件中添加或更新以下两项配置，即可完成下载源的更改：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple
[install]
trusted-host = mirrors.aliyun.com

方法二，通过命令行修改配置文件：

在Windows系统中，也可通过命令行修改配置文件，在 cmd 命令行中依次运行以下两条命令，即可完成下载源的更改：

# 更改全局的包索引源地址
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple
# 将新下载源添加为信任的主机，以告诉pip在与这个镜像源交互时忽略SSL证书的校验错误
pip config set install.trusted-host mirrors.aliyun.com

3. 其他源相关命令

# 查看当前下载源地址：
pip config list
# 取消设置全局的index-url配置，换回默认的包索引源：
pip config unset global.index-url

4. 国内镜像源收集

# 阿里云
http://mirrors.aliyun.com/pypi/simple/
# 腾讯云
https://mirrors.cloud.tencent.com/pypi/simple/
# 华为云
https://mirrors.huaweicloud.com/repository/pypi/simple/
# 百度
https://simple.baidu.com/pypi/simple
# 豆瓣
http://pypi.douban.com/simple/
# 网易
https://mirrors.163.com/pypi/simple/
# 清华大学
https://pypi.tuna.tsinghua.edu.cn/simple
# 中国科学技术大学
https://pypi.mirrors.ustc.edu.cn/simple

5. pip 其他相关命令

# 安装包：
pip install SomePackage
# 升级包：
pip install --upgrade SomePackage
# 卸载包：
pip uninstall SomePackage
# 列出已安装的包：
pip list
# 查找PyPI上的包：
pip search SomePackage