---

问题描述

---

在使用 Python 进行开发时，我们经常需要使用 pip 来安装第三方库。然而，很多情况下 pip install 非常慢，甚至可能无法完成。如下图所示，安装 pandas 库的速度仅 10.2 kB/s：

为什么 pip 速度这么慢？

---

pip是一个非常流行的python包管理工具，在命令行中只需要输入pip install package_name，就可以自动安装第三方库。然而pip是从pypi中下载库文件的，pypi是python官方第三方库的仓库（下图），它用的是国外的服务器，下载速度自然很慢。所以不是pip慢，而是pypi慢。

问题出在 pip 源上，那么只需要把pip的下载源修改为国内的镜像站即可。

解决方案

---

1. 使用国内镜像源

国内许多知名高校和企业提供了 pip 镜像服务，速度相对较快。以下是几个常用的国内镜像源：

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

以清华大学 tuna 镜像源为例，你可以临时使用或永久配置国内的镜像源来加速下载。

# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name

# 永久配置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

如下图所示，我这里永久更改镜像源：

永久更改完成后，会在上图红框的路径下生成一个配置文件，内容如下图所示。这样配置后，每次使用 pip install 时都会默认使用这个镜像源。

同理，你可以选择直接编辑 pip 配置文件，以永久更改默认源。不同操作系统的配置文件默认地址如下：

• Windows: C:\Users\<用户名>\pip\pip.ini
• macOS/Linux: ~/.pip/pip.conf

2. 配置多个镜像源

如果希望 pip 能够尝试多个镜像源以提高下载成功率，可以在配置文件中添加多个 extra-index-url：

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

3. 使用第三方工具

使用如 pipx 或 Poetry 等第三方工具，这些工具通常有更好的缓存机制和更优的依赖管理。

4. 手动下载后本地安装

对于特别大的包，可以在 PyPi等官方源网站 手动下载 .whl 文件或源代码包，然后使用 pip 进行本地安装：

pip install /path/to/package.whl

5. 优化网络环境

确保网络连接稳定，如果可能，使用有线连接代替无线连接。此外，尝试使用网络加速器或 VPN 也可能有所帮助（因为pip默认源是国外服务器）。

6. 更新 pip 版本

使用最新版本的 pip 可能会获得更好的性能和错误修复：

pip install --upgrade pip

测试效果

---

以清华大学 tuna 镜像源为例，完成永久配置镜像源后再次尝试下载依赖包，速度接近 1MB/s，是默认源的几十甚至上百倍：

---

创作不易，麻烦点点赞和关注咯！

---

学术会议征稿

• 想要了解国内主办的覆盖学科最全最广的学术会议，请前往【所有会议官网】：
  学术会议官网www.ais.cn

---