pip下载速度慢解决方法

简单来说，这不是本地网络的问题，而是连接的服务器位置和网络路径不同导致的。

• pip 下载慢：pip 默认从国外的官方 PyPI (Python Package Index) 服务器（pypi.org）下载。由于物理距离遥远和国际网络出口的缘故，从国内访问速度很慢，甚至会因为超时而失败。
• GitHub 克隆快：GitHub 在全球部署了大量的 CDN (内容分发网络) 节点，包括在国内或周边地区有专门的服务器和加速节点。当您 git clone 时，请求会被导向最近、速度最快的服务器，因此体验很好。

核心解决方法：为 pip 更换国内镜像源

要解决 pip 下载慢的问题，最直接、最有效的办法就是将 pip 的下载源从官方服务器切换到国内的镜像服务器。这些国内镜像站（如清华大学、阿里云、豆瓣等）会定期从 PyPI 官方同步所有软件包，从国内镜像下载就相当于在访问国内网站，速度会得到质的飞跃。

以下提供几种操作方法，从一劳永逸到临时使用，可以按需选择。

方法一：永久更换镜像源（一劳永逸，强烈推荐）

这种方法会修改 pip 的全局配置，以后每次使用 pip install 都会自动通过国内镜像下载，无需额外操作。

1. 使用命令行一键配置 (最简单)

这是最推荐的方式，一条命令即可自动完成配置。

打开终端（Windows 用户使用 CMD 或 PowerShell，macOS/Linux 用户使用 Terminal），执行以下命令即可。推荐使用清华源或阿里源，两者都非常稳定快速。

使用清华大学镜像源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

或者使用阿里云镜像源：

pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/

执行命令后，pip 就会创建或修改配置文件，将新的镜像源设为默认。现在可以像平常一样使用 pip install xxx，体验飞一般的速度吧！

2. 手动创建配置文件 (原理方式)

如果命令行方式因权限等问题失败，可以手动创建配置文件。

• 对于 Windows 用户：

  1. 在文件资源管理器的地址栏输入 %APPDATA% 并按回车。
  2. 进入一个类似 C:\Users\你的用户名\AppData\Roaming 的目录。
  3. 在这里新建一个名为 pip 的文件夹。
  4. 进入 pip 文件夹，新建一个文本文档，将其重命名为 pip.ini (注意后缀是 .ini)。
  5. 用记事本打开 pip.ini 文件，粘贴以下内容并保存：

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

• 对于 macOS 和 Linux 用户：

  1. 配置文件路径通常在 ~/.config/pip/pip.conf 或 ~/.pip/pip.conf。
  2. 在用户主目录下，执行 mkdir -p ~/.config/pip (如果目录不存在)。
  3. 然后创建并编辑文件 ~/.config/pip/pip.conf，粘贴以下内容并保存：

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

方法二：临时使用镜像源（单次加速）

如果只是偶尔需要加速某一个包的下载，不想修改全局配置，可以在安装时使用 -i 参数临时指定镜像源。

例如，使用豆瓣源安装 numpy：

pip install numpy -i http://pypi.douban.com/simple/

或者使用清华源安装 aiohttp：

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

这种方式只对当前这一次命令有效，下次使用 pip install 时依然会使用默认的官方源。

方法三：使用工具一键切换（懒人方案）

社区也有开发者制作了专门用于快速切换 pip 源的工具，例如 pqi。

1. 首先，需要先用临时加速的方式把这个工具装上：

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

2. 之后就可以用它来管理镜像源了：

   • 查看所有可用的源：pqi ls
   • 切换到清华源：pqi use tuna
   • 切换回官方源：pqi use pypi

总结

建议直接使用方法一中的命令行方式进行配置，这是最现代、最简单且最有效的方法。