解决 pip 安装慢的问题：国内镜像源加速指南

问题的根源：为什么 pip 下载慢？

在使用 pip 安装 Python 包时，总会感觉下载速度特别慢，有时候甚至会因为网络超时而安装失败。究其原因，主要是因为 pip 默认的官方源服务器在国外，国内访问自然就慢了。为了解决这个问题，最直接有效的办法就是把下载源切换到国内的镜像服务器。

这里记录一下两种设置 pip 镜像源的方法：一种是临时的，一种是永久的。

---

方法一：临时使用镜像源

如果只是偶尔想给某个包装个速，或者在别人的环境上临时操作一下，用这个方法最方便。它不会修改 pip 的默认配置，只需要在安装命令后面加上 -i 或 --index-url 参数，指定本次安装使用的镜像源地址就行。

示例

比如，我想用清华大学的镜像源来安装 requests 这个包，命令就可以这么写：

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

常用国内镜像源

下面整理了几个常用的国内镜像地址，可以根据自己的网络情况选择：

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

---

方法二：永久配置镜像源

每次安装都手动加参数还是太麻烦了，对于自己的开发环境，我更倾向于一劳永逸的解决方案——直接修改配置文件，让 pip 默认就使用国内镜像源。

1. 找到配置文件路径

pip 的配置文件位置根据操作系统的不同而不同：

• Windows: 在文件资源管理器的地址栏输入 %APPDATA%\pip，然后在这个文件夹里创建一个 pip.ini 文件。
• macOS / Linux: 配置文件路径是 ~/.config/pip/pip.conf。如果 ~/.config/pip 目录或 pip.conf 文件不存在，需要手动创建。

2. 修改或创建配置文件

用文本编辑器打开这个配置文件（没有就新建一个），然后把下面的内容粘贴进去。这里还是以清华大学的源为例：

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

3. 保存并验证

保存文件后，这个配置就永久生效了。之后再使用 pip install 命令安装任何包，都会自动从配置好的国内镜像源下载，速度会快非常多。

可以随便装个小包测试一下效果，比如：

pip install numpy

如果看到下载速度有质的飞跃，那就说明配置成功了。

---

总结

• 临时使用： 适合在临时环境或者偶尔需要加速的场景，命令简单直接。
• 永久配置： 自己的开发环境首选，一次配置，后续所有安装都会加速，能极大提升效率。

通过这两种方法，基本上就能告别 pip 下载慢的烦恼了。

---