Python解決pip清華源連接超時問題的方法總結(jié)
更新時間：2025年06月20日 11:21:04 作者：旅途中的寬~
我們在安裝Python包時,可能會遇到pip連接清華鏡像源超時,本文給大家介紹解決方法包括更換鏡像源、增加超時時間、檢查網(wǎng)絡(luò)代理/防火墻、禁用IPv6、手動下載安裝及更新pip,優(yōu)先嘗試更換鏡像源或調(diào)整超時設(shè)置,需要的朋友可以參考下
在安裝Python包的時候，出現(xiàn)了下面的錯誤：
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 鏡像源
清華源可能暫時不可用，可以嘗試其他國內(nèi)鏡像源（如阿里云、豆瓣等）：
pip install numba -i https://mirrors.aliyun.com/pypi/simple/
大概率能順利成功：
或使用官方源（但速度可能較慢）：
pip install numba -i https://pypi.org/simple
方法 2：增加超時時間
如果網(wǎng)絡(luò)延遲較高，可以延長超時時間：
pip --default-timeout=100 install numba
方法 3：檢查網(wǎng)絡(luò)環(huán)境
- 代理問題：如果你使用了 VPN 或代理，嘗試關(guān)閉它們。
- 防火墻限制：確保防火墻或安全軟件沒有阻止 pip 訪問網(wǎng)絡(luò)。
- DNS 問題：嘗試更換 DNS（如
8.8.8.8或114.114.114.114）。
方法 4：臨時關(guān)閉 IPv6
某些網(wǎng)絡(luò)環(huán)境下 IPv6 可能導(dǎo)致超時，可以嘗試禁用：
pip install --prefer-ipv4 numba
方法 5：手動下載并安裝
如果問題持續(xù)，可以手動下載 wheel 文件安裝：
- 訪問 PyPI 官網(wǎng) 下載對應(yīng)版本的
.whl文件。 - 通過本地安裝：
pip install numba-xxx.whl
方法 6：更新 pip 和工具鏈
確保 pip 和 setuptools 是最新版：
python -m pip install --upgrade pip setuptools
總結(jié)建議
優(yōu)先嘗試 更換鏡像源（如阿里云）或 增加超時時間。如果問題仍然存在，可能是網(wǎng)絡(luò)環(huán)境限制，需檢查代理或防火墻設(shè)置。
到此這篇關(guān)于Python解決pip清華源連接超時問題的方法總結(jié)的文章就介紹到這了,更多相關(guān)Python pip清華源連接超時內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Django REST framework 單元測試實例解析
這篇文章主要介紹了Django REST framework 單元測試實例解析,文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2019-11-11
該文介紹了在PyCharm中使用Jupyter創(chuàng)建.ipynb文件的過程,具體步驟包括安裝Jupyter,以及在PyCharm中創(chuàng)建.ipynb文件等2026-05-05
這篇文章主要為大家詳細介紹了使用Python實現(xiàn)操作mongodb的相關(guān)知識,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2025-01-01
人臉口罩佩戴檢測(識別)是當(dāng)前急需的應(yīng)用,而YOLOv5是目前流行的強悍的目標(biāo)檢測技術(shù),下面這篇文章主要給大家介紹了關(guān)于Python+Yolov5人臉口罩識別的相關(guān)資料,需要的朋友可以參考下2022-12-12
這篇文章主要介紹了Python中的logging模塊實現(xiàn)日志打印，其實不止print打印日志方便排查問題，Python自帶的logging模塊，也可以很簡單就能實現(xiàn)日志的配置和打印，下面來看看具體的實現(xiàn)過程吧,需要的朋友可以參考一下2022-03-03
Python+selenium點擊網(wǎng)頁上指定坐標(biāo)的實例
今天小編就為大家分享一篇Python+selenium點擊網(wǎng)頁上指定坐標(biāo)的實例，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-07-07
Python3+Selenium+Chrome實現(xiàn)自動填寫WPS表單
本文通過python3、第三方python庫Selenium和谷歌瀏覽器Chrome，完成WPS表單的自動填寫,通過實例代碼給大家介紹的非常詳細，具有一定的參考借鑒價值，需要的朋友可以參考下2020-02-02
使用Python實現(xiàn)PDF文檔自動化編輯與圖表繪制的全指南
PDF文檔處理在日常工作中太常見了,手動處理費時費力還容易出錯,用Python來搞定這些重復(fù)性工作非常高效,今天我就帶大家用Python來實現(xiàn)PDF文檔的自動化編輯和數(shù)據(jù)可視化,包括PDF的讀取、修改、合并,以及用數(shù)據(jù)繪制漂亮的圖表,需要的朋友可以參考下2025-08-08
這篇文章主要介紹了Python 判斷文件或目錄是否存在的實例代碼，非常不錯，具有一定的參考借鑒價值,需要的朋友可以參考下2018-07-07
pycharm無法安裝第三方庫的問題及解決方法以scrapy為例(圖解)
這篇文章主要介紹了pycharm無法安裝第三方庫的解決辦法以scrapy為例,本文通過圖文并茂的形式給大家介紹的非常詳細，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2020-05-05