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清华源连接超时内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • python爬取m3u8连接的视频

    python爬取m3u8连接的视频

    这篇文章主要为大家详细介绍了python如何爬取m3u8连接的视频,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-02-02
  • 浅谈pandas.cut与pandas.qcut的使用方法及区别

    浅谈pandas.cut与pandas.qcut的使用方法及区别

    这篇文章主要介绍了浅谈pandas.cut与pandas.qcut的使用方法及区别,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-03-03
  • Python报错:OSError: [Errno 22] Invalid argument解决方案及应用实例

    Python报错:OSError: [Errno 22] Invalid argument解决方案及应用实例

    最近跑别人的项目遇到一个这样的问题一开始以为是没有用管理员的权限运行,导致创建不了日志文件后来发现是和windows的命名规则冲突了,这篇文章主要给大家介绍了关于Python报错:OSError: [Errno 22] Invalid argument的解决方案及应用实例,需要的朋友可以参考下
    2024-07-07
  • 浅谈Python类中的self到底是干啥的

    浅谈Python类中的self到底是干啥的

    这篇文章主要介绍了浅谈Python类中的self到底是干啥的,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-11-11
  • 详解用Python实现自动化监控远程服务器

    详解用Python实现自动化监控远程服务器

    这篇文章主要介绍了用Python实现自动化监控远程服务器,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-05-05
  • 使用python爬虫实现子域名探测问题

    使用python爬虫实现子域名探测问题

    子域名枚举是为一个或多个域查找子域的过程,它是信息收集阶段的重要组成部分,这篇文章主要介绍了使用python实现子域名探测,需要的朋友可以参考下
    2022-07-07
  • Django makemigrations migrate执行成功但不创建数据库表的解决

    Django makemigrations migrate执行成功但不创建数据库表的解决

    这篇文章主要介绍了Django makemigrations migrate执行成功但不创建数据库表的解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-09-09
  • opencv-python 开发环境的安装、配置教程详解

    opencv-python 开发环境的安装、配置教程详解

    这篇文章主要介绍了opencv-python 开发环境的安装、配置,本文分步骤通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-09-09
  • Python使用captcha制作验证码的实现示例

    Python使用captcha制作验证码的实现示例

    本文主要介绍了Python使用captcha制作验证码的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • python发送邮件实例分享

    python发送邮件实例分享

    这篇文章主要为大家详细介绍了python发送邮件实例分享,教大家如何实现邮件发送功能,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07

最新评论