大家好，我是爱编程的喵喵。双985硕士毕业，现担任全栈工程师一职，热衷于将数据思维应用到工作与生活中。从事机器学习以及相关的前后端开发工作。曾在阿里云、科大讯飞、CCF等比赛获得多次Top名次。喜欢通过博客创作的方式对所学的知识进行总结与归纳，不仅形成深入且独到的理解，而且能够帮助新手快速入门。

  本文主要介绍了pip install timeout(即pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host=‘files.pythonhosted.org’, port=443): Read timed out).解决方案，希望能对新手有所帮助。

  更加完整的报错信息如下所示：

文章目录

• 1. 问题描述
• 2. 解决方案
• • 2.1 方案一
  • 2.2 方案二
  • 2.3 方案三

1. 问题描述

  今天在新电脑通过安装anaconda配置Python环境后，使用pip命令安装库gevent，但在安装进度条大约为80%时，出现了错误：

  最下方的报错信息如下所示：

  更加完整的报错信息如下所示：

2. 解决方案

  根据pip的官方文档(链接为https://pip.pypa.io/en/stable/cli/pip/)可知，pip下载库的默认时间为15s(秒)，也就是说如果下载库的时间超过15s就会触发timed out的错误。

  需要特别注意的是，所有命令必须要在cmd中执行。如果不想深入研读，只想快速解决问题，直接跳到方案二中的结合设置timeout时间和使用清华软件镜像站的命令的使用方法即可。

2.1 方案一

   增大timeout时间，具体pip安装命令如下，其中xxx即为库名称，比如pandas：

pip install --default-timeout=1000  xxx

2.2 方案二

  由于下载库的默认服务器域名为files.pythonhosted.org，根据域名查询可得，服务器并不位于大陆，传输距离较远，所以下载速度较慢。

  所以可通过设置下载服务器为国内镜像站(简单来说，镜像站就是内容相同并且位于国内的网站)，如果是单次下载，直接使用pip命令下载即可，其中xxx即为库名称，如pandas，下列命令使用的是清华软件镜像站：

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

  如果想要一劳永逸(永久设置为清华软件镜像站)，设置方法为：

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

  结合设置timeout时间和使用清华软件镜像站的命令如下所示，其中xxx即为库名称：

pip install --default-timeout=1000 -i https://pypi.tuna.tsinghua.edu.cn/simple  xxx

  为了方便新手理解，举个例子：

pip install --default-timeout=1000 -i https://pypi.tuna.tsinghua.edu.cn/simple gevent

  从龟速变成了飞一般的下载速度，如下图所示，其中Successfully installed表示安装成功：

2.3 方案三

  如果尝试了方案一和方案二依然出现timeout的错误，那只能说明网络环境太差。如果使用的是校园网或者公司网环境，不妨使用手机移动流量并设置热点，然后将电脑连接到热点中进行pip命令安装。