pip 安装库速度慢的解决方案：国内镜像源配置指南

pip 安装慢的原因与解决思路

对于 Python 开发者而言，使用 pip 安装第三方库是日常开发中的常规操作。然而，默认情况下连接国外源下载速度往往非常缓慢，不仅耗费大量时间，还经常导致下载完成后安装失败或出现错误。

为了解决这一痛点，将 pip 的安装源替换为国内镜像服务器，可以显著提升下载速率，同时大幅提高软件包安装的成功率。

常用国内镜像源列表

目前可用的国内主流镜像源列表如下：

需要注意的是，新版 Ubuntu 系统强制要求使用 HTTPS 协议的源，因此配置时务必注意协议类型。

清华大学开源软件镜像站：https://pypi.tuna.tsinghua.edu.cn/simple

阿里云开源镜像站：http://mirrors.aliyun.com/pypi/simple/

中国科学技术大学开源镜像站：https://pypi.mirrors.ustc.edu.cn/simple/

华中科技大学开源镜像站：http://pypi.hustunique.com/

山东理工大学开源镜像站：http://pypi.sdutlinux.org/

豆瓣开源镜像站：http://pypi.douban.com/simple/

临时使用国内镜像源

除了永久修改配置，用户也可以在执行安装命令时临时指定镜像源。

在使用 pip 命令时，可以通过添加 -i 参数并指定镜像地址来实现临时切换。

例如，执行命令：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyspider，即可指定从清华大学镜像源下载并安装 pyspider 库。

永久配置国内镜像源

如果希望一劳永逸地解决下载慢的问题，可以修改配置文件实现永久生效。

在 Linux 系统中，需要修改用户目录下的 ~/.pip/pip.conf 文件。如果该文件不存在，请手动创建对应的文件夹及文件。注意文件夹名以“.”开头，这表示它是一个隐藏文件夹。

配置文件的具体内容应包含全局源设置及可信主机声明，示例如下：

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

在 Windows 系统中，操作略有不同。需要在用户目录下创建一个名为 pip 的文件夹（例如：C:\Users\xx\pip），并在该文件夹内新建一个名为 pip.ini 的文件。文件内的配置内容与 Linux 下的 pip.conf 保持一致。

实际安装场景示例

以下补充一个具体的应用场景示例，帮助理解实际操作流程。

假设当前场景是：

我们需要安装 Django 库。

在命令行终端（cmd）中执行标准安装命令：

pip install Django

此时可能会发现下载和安装文件的进度非常缓慢。

造成这一现象的原因是：pip 默认访问的下载源网站是 https://pypi.Python.org/simple/。

由于该网站位于国外，受网络环境影响，下载速度通常较慢。

针对上述问题，推荐的解决办法是：

使用国内镜像源进行加速。

在命令行中，可以通过更改命令参数来指定使用国内源。

# 指定使用豆瓣源 pip install Django -i https://pypi.douban.com/simple

# 或者指定使用清华大学源 pip install Django -i https://pypi.tuna.tsinghua.edu.cn/simple

经过上述配置后，今后每次使用 pip 安装库时，只需在命令末尾添加 -i https://pypi.douban.com/simple（或你选择的镜像地址），即可保证稳定的下载速度。