如何给 pip 更换国内源，并配置 Python 的国内镜像

经常搞 Python 开发的小伙伴们可能会遇到一个常见问题：使用 pip 安装第三方库速度太慢，甚至有时候还会超时，原因多半是因为我们默认的 pip 源服务器在国外。为解决这类困扰，可以切换到国内的镜像源，享受更快的下载速度。今天这篇博客就来聊聊如何快速配置 pip 的国内源。

温馨提示：如果你是 Python 新手，可以先通过 python --version、pip --version 等命令确认好自己的 Python 和 pip 版本再进行操作。

1. 为什么要切换国内源？

1. 下载速度更快：默认 pip 是从 Python 官方源（pypi.org）下载，网络状况不稳定，常常会出现下载速度慢或失败的情况。
2. 稳定性更高：国内镜像一般都在国内服务器，连接更稳定，出错率也更低。
3. 节省时间：加快依赖库的安装速度，在一定程度上能提高开发效率。

2. 常见的国内镜像源地址

这里列出几家常用的国内镜像源，大家可以根据自己的需要进行选择。

3. 临时使用国内源

如果仅是临时切换某一次安装，那么使用命令行中的 -i 参数就可以了。比如你打算从清华源安装 requests 库，可以这样做：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

这条命令仅在这一次安装时生效，后续安装依旧会恢复默认的官方源。

4. 永久修改 pip 源

为了每次都能自动使用国内镜像，我们需要进行全局配置或用户级配置。步骤相对简单，以下展示三大系统的常用配置方式。

4.1 Windows 系统

1. 创建配置文件
   Windows 下默认的 pip 配置文件是 pip.ini 或者 pip.conf（不同 pip 版本可能稍有差异）。

2. 通常建议放在：

   C:\Users\<你的用户名>\AppData\Roaming\pip\pip.ini
   

   如果没有 pip 文件夹，可以手动创建。

3. 写入镜像地址
   打开或者新建 pip.ini，写入以下内容：

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

   这里的 trusted-host 是为了避免某些版本下会提示证书不被信任的问题。

4. 验证是否生效
   你可以在命令行里输入：

   pip config list
   

   或者直接安装一个库试试看：

   pip install flask
   

   看看输出的 Looking in indexes 是否变成了你配置的国内源。

4.2 macOS / Linux 系统

在类 Unix 系统上（包括 macOS 和大多数 Linux 发行版），pip 的配置文件默认放置路径通常为 ~/.config/pip/pip.conf 或者 ~/.pip/pip.conf。

1. 找到或新建配置文件

   # 进入 .config 文件夹
   cd ~/.config
   # 如果没有 pip 目录就创建一个
   mkdir -p pip
   # 进入 pip 目录
   cd pip
   # 用你喜欢的编辑器来编辑 pip.conf，比如 nano、vi 或者其他
   nano pip.conf
   

2. 写入国内镜像地址
   和 Windows 下类似，内容格式相同：

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

3. 保存并测试
   保存文件后，直接测试：

   pip install flask
   

   是否有 Looking in indexes 的提示。如果是你配置的国内源，说明生效成功。

5. 使用多个镜像源

有时候，我们可能会想要指定多个镜像源来防止某一个源出现故障。pip 并不支持直接合并多个 index-url，但是你可以配合 --extra-index-url 的参数来使用额外的索引。例如，在命令行临时使用：

pip install <库名> --index-url https://pypi.tuna.tsinghua.edu.cn/simple --extra-index-url https://mirrors.aliyun.com/pypi/simple

这样当清华源上没有找到对应包时，会去阿里云再尝试一次。

6. 常见问题与小技巧

1. pip 版本过旧

2. 如果你的 pip 版本太老，可能不支持某些新特性，建议先升级：

   pip install --upgrade pip
   

3. 证书验证不通过

4. 可以加上 trusted-host，或者将其写到配置文件中去。
5. 如果实在不行，可以在命令行里加 --trusted-host pypi.tuna.tsinghua.edu.cn 之类的。

6. 多环境冲突

7. 有时候你可能有多个 Python 版本，或者用了 Anaconda、Miniconda。需要对每个环境的 pip 进行分别配置，或者使用环境专属的 pip.conf。
8. 也可以在虚拟环境中使用临时指定源的方式安装，不会影响全局。

9. Linux 系统权限问题

10. 有时全局安装需要 sudo，但也会导致一些权限问题。建议使用 --user 或者虚拟环境（如 venv）进行安装，以免跟系统包冲突。

以上就是关于如何更换 pip 国内源的简单教程。总结一下，最关键的就是找到配置文件路径，然后把 [global] 下的 index-url 改成国内镜像地址，就能享受更快更稳定的下载速度啦。如果你是 Python 重度使用者，建议长期配置国内源，既节省时间又不用每次手动敲命令。

作者：孽小倩