如何修复Python安装时出现的ReadTimeoutError报错并实现断点续传？-Python教程-PHP中文网

根本原因是 pip 默认读取超时仅15秒，大包或国内源响应慢时易触发readtimeouterror；解决方式是用--timeout和--retries延长单次等待并重试，或配置pip.conf全局设置清华源、timeout=120、retries=7。

如何修复python安装时出现的readtimeouterror报错并实现断点续传？

为什么 pip install 会卡在 ReadTimeoutError？

根本原因不是网络“断了”，而是 pip 默认的超时时间太短（15秒），而大包（比如 torch、tensorflow）或国内源响应慢时，下载中途没收到数据包就会直接抛出 ReadTimeoutError。它和 DNS 失败、连接拒绝不同，是“连上了但等太久”。

用 --timeout 和 --retries 强制延长等待并重试

这是最直接有效的修复方式，无需改源或装额外工具。关键不是调高单次超时，而是配合重试机制——因为很多超时其实是瞬时抖动导致的。

pip install --timeout 60 --retries 5 package_name：把单次读取等待拉到 60 秒，失败后最多再试 5 次
对 wheel 包特别有效，因为 pip 下载时是分块读取的，--retries 能让失败的 chunk 重新拉，接近“断点续传”效果
注意：--timeout 控制的是 socket 级读操作超时，不是整个安装耗时限制

换源 + 配置全局 timeout 才能一劳永逸

临时加参数治标，改配置文件才能避免每次敲一堆 flag。国内用户强烈建议用清华源，并把 timeout 设为 120：

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的双功能合体技能，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途：；核心要点📝 题解模式：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

创建或编辑 ~/.pip/pip.conf（Linux/macOS）或 %APPDATA%\pip\pip.ini（Windows）

写入以下内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120
retries = 7

这样所有 pip install 命令默认生效，且清华源本身 CDN 稳定，比默认 pypi.org 更少触发 ReadTimeout

真正需要断点续传时，得绕过 pip 直接下 wheel

pip 本身不支持磁盘级断点续传（即下载一半中断后 resume），所谓“续传”只是靠重试拉新 chunk。如果真遇到反复失败的大包（如 torch-2.3.0+cu121-cp39-cp39-linux_x86_64.whl），就得手动干预：

先用 pip download --no-deps --platform manylinux2014_x86_64 --python-version 39 --abi cp39 package_name 获取 wheel URL
用 wget -c 或 curl -C - 下载到本地（-c 表示续传）
最后 pip install ./downloaded_file.whl
注意 wheel 的 --platform、--python-version 必须和你的环境严格匹配，否则 pip 会跳过它去在线搜