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

前言

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

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

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

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

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

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

• 清华大学 TUNA：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里云：https://mirrors.aliyun.com/pypi/simple/
• 豆瓣(douban)：https://pypi.douban.com/simple/
• 中国科学技术大学(USTC)：https://pypi.mirrors.ustc.edu.cn/simple/

3. 临时使用国内源

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

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

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

4. 永久修改 pip 源

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

4.1 Windows 系统

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

  • 通常建议放在：

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

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

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

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

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

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

  pip config list
  

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

  pip install flask
  

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

4.2 macOS / Linux 系统

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

• 找到或新建配置文件

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

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

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

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

  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. 常见问题与小技巧

• pip 版本过旧

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

    pip install --upgrade pip
    

• 证书验证不通过

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

• 多环境冲突

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

• Linux 系统权限问题

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

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

总结

到此这篇关于如何给pip更换国内源并配置Python的国内镜像的文章就介绍到这了,更多相关pip更换国内源并配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！