环境安装：pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool解决方案

最新推荐文章于 2025-04-27 16:42:44 发布

蓝色的紫

最新推荐文章于 2025-04-27 16:42:44 发布

阅读量1.1k

点赞数 1

分类专栏： Bug记录文章标签： python pip 人工智能

本文链接：https://blog.youkuaiyun.com/DHB1289752316/article/details/117849937

版权

Bug记录专栏收录该内容

7 篇文章

订阅专栏

在尝试使用pip安装Python库时遇到HTTPSConnectionPool的ReadTimeoutError，这通常是由于网络延迟导致的。为了解决这个问题，可以尝试增加超时时间或者更换下载源。增加超时时间的命令是`pip --default-timeout=100 install 库名称`。如果该方法无效，可以考虑使用国内的镜像源，如豆瓣、清华、阿里云、中国科学技术大学或华中理工大学的镜像，这通常能显著提高下载速度。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

项目场景：环境安装

问题描述：

pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out. 出现错误）：

pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out.

原因分析：网络延迟过高

解决方案：

1、加入超时机制（亲测部分时候有效）

pip --default-timeout=100 install 库名称

2、修改下载源（亲测最有效）

pip --default-timeout=100 install 库名称 -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com

3、源推荐

豆瓣：http://pypi.douban.com/simple/
清华：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/