Python解决pip清华源连接超时问题的方法总结
更新时间：2025年06月20日 11:21:04 作者：旅途中的宽~
我们在安装Python包时,可能会遇到pip连接清华镜像源超时,本文给大家介绍解决方法包括更换镜像源、增加超时时间、检查网络代理/防火墙、禁用IPv6、手动下载安装及更新pip,优先尝试更换镜像源或调整超时设置,需要的朋友可以参考下
在安装Python包的时候，出现了下面的错误：
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='pypi.tuna.tsinghua.edu.cn', port=443): Read timed out. (read timeout=15)")': /simple/sigpy/
WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectTimeoutError(<pip._vendor.urllib3.connection.HTTPSConnection object at 0x000001B3C207F490>, 'Connection to pypi.tuna.tsinghua.edu.cn timed out. (connect timeout=15)')': /simple/sigpy/
然后紧跟着：
报错类型为：
pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='pypi.tuna.tsinghua.edu.cn', port=443): Read timed out.
这个错误表明 pip 在尝试从清华镜像源（pypi.tuna.tsinghua.edu.cn）下载第三方包时连接超时。以下是几种解决方法：（以安装numba包为例）
方法 1：更换 pip 镜像源
清华源可能暂时不可用，可以尝试其他国内镜像源（如阿里云、豆瓣等）：
pip install numba -i https://mirrors.aliyun.com/pypi/simple/
大概率能顺利成功：
或使用官方源（但速度可能较慢）：
pip install numba -i https://pypi.org/simple
方法 2：增加超时时间
如果网络延迟较高，可以延长超时时间：
pip --default-timeout=100 install numba
方法 3：检查网络环境
- 代理问题：如果你使用了 VPN 或代理，尝试关闭它们。
- 防火墙限制：确保防火墙或安全软件没有阻止 pip 访问网络。
- DNS 问题：尝试更换 DNS（如
8.8.8.8或114.114.114.114）。
方法 4：临时关闭 IPv6
某些网络环境下 IPv6 可能导致超时，可以尝试禁用：
pip install --prefer-ipv4 numba
方法 5：手动下载并安装
如果问题持续，可以手动下载 wheel 文件安装：
- 访问 PyPI 官网 下载对应版本的
.whl文件。 - 通过本地安装：
pip install numba-xxx.whl
方法 6：更新 pip 和工具链
确保 pip 和 setuptools 是最新版：
python -m pip install --upgrade pip setuptools
总结建议
优先尝试 更换镜像源（如阿里云）或 增加超时时间。如果问题仍然存在，可能是网络环境限制，需检查代理或防火墙设置。
到此这篇关于Python解决pip清华源连接超时问题的方法总结的文章就介绍到这了,更多相关Python pip清华源连接超时内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
Django REST framework 单元测试实例解析
这篇文章主要介绍了Django REST framework 单元测试实例解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2019-11-11
该文介绍了在PyCharm中使用Jupyter创建.ipynb文件的过程,具体步骤包括安装Jupyter,以及在PyCharm中创建.ipynb文件等2026-05-05
这篇文章主要为大家详细介绍了使用Python实现操作mongodb的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下2025-01-01
人脸口罩佩戴检测(识别)是当前急需的应用,而YOLOv5是目前流行的强悍的目标检测技术,下面这篇文章主要给大家介绍了关于Python+Yolov5人脸口罩识别的相关资料,需要的朋友可以参考下2022-12-12
这篇文章主要介绍了Python中的logging模块实现日志打印，其实不止print打印日志方便排查问题，Python自带的logging模块，也可以很简单就能实现日志的配置和打印，下面来看看具体的实现过程吧,需要的朋友可以参考一下2022-03-03
今天小编就为大家分享一篇Python+selenium点击网页上指定坐标的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2019-07-07
Python3+Selenium+Chrome实现自动填写WPS表单
本文通过python3、第三方python库Selenium和谷歌浏览器Chrome，完成WPS表单的自动填写,通过实例代码给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下2020-02-02
PDF文档处理在日常工作中太常见了,手动处理费时费力还容易出错,用Python来搞定这些重复性工作非常高效,今天我就带大家用Python来实现PDF文档的自动化编辑和数据可视化,包括PDF的读取、修改、合并,以及用数据绘制漂亮的图表,需要的朋友可以参考下2025-08-08
这篇文章主要介绍了Python 判断文件或目录是否存在的实例代码，非常不错，具有一定的参考借鉴价值,需要的朋友可以参考下2018-07-07
pycharm无法安装第三方库的问题及解决方法以scrapy为例(图解)
这篇文章主要介绍了pycharm无法安装第三方库的解决办法以scrapy为例,本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2020-05-05
最新评论