直接换源并调高超时阈值可解决95%的pip install超时问题：换国内镜像源（如清华源https://pypi.tuna.tsinghua.edu.cn/simple）规避海外网络延迟，再通过--default-timeout=1000或pip config set global.timeout 1000延长超时时间，二者配合才能有效应对大包下载中断。
直接换源 + 调超时，95% 的 pip install 超时问题当场解决。这不是玄学，是网络链路和 pip 默认配置共同作用的结果——PyPI 官方源在海外，国内直连大概率卡在 DNS 解析、TLS 握手或大包下载阶段，15 秒超时根本不够用。
换国内镜像源（临时 or 永久）
临时生效最省事，适合单次安装或 CI 环境：
- 加
-i参数指定镜像，比如装torch：pip install torch -i https://pypi.tuna.tsinghua.edu.cn/simple - 清华源、中科大源、阿里云源都稳定，
https://pypi.mirrors.ustc.edu.cn/simple/偶尔会因同步延迟漏掉最新版.whl，不建议用于 PyTorch/TensorFlow 这类更新快的大包 - 注意：部分镜像（如豆瓣）不支持 HTTPS 重定向，如果报
Could not fetch URL，换成带https://的地址或加--trusted-host
调高 timeout 阈值（必须配合换源）
只调 timeout 不换源，大概率还是超时——因为慢的根本原因是路由绕行，不是连接建立慢。但换源后，大包（如 torch-2.4.0+cu121 1.2GB）仍可能因网速波动中断：
Ai Podcast Pipeline
下载
从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。
- 临时调：加
--default-timeout=1000，例如：pip install -r requirements.txt --default-timeout=1000 -i https://pypi.tuna.tsinghua.edu.cn/simple - 永久调：运行
pip config set global.timeout 1000，写入配置后所有后续安装都会生效 - 别设成 10000 或更高——pip 在下载中途断连时不会自动续传，超时值过大只是让失败来得更晚，不是更可靠
遇到 ReadTimeoutError / Retrying 循环怎么办
这是 pip 已经开始重试但始终失败的明确信号，说明当前链路不可用：
- 先确认是否用了
-i或配置了镜像源——没换源就调 timeout 是白忙活 - 检查公司/校园网是否限制了 443 端口或屏蔽了镜像域名，可尝试在浏览器打开
https://pypi.tuna.tsinghua.edu.cn/simple/requests/看能否列出版本 - 执行
pip cache info查看缓存路径，如果磁盘满或权限异常，pip cache purge清一次再试 - 极少数情况是本地 DNS 污染，临时改 hosts：
101.6.6.17 pypi.tuna.tsinghua.edu.cn（以清华源当前 IP 为准）
真正麻烦的不是超时本身，而是超时掩盖了更底层的问题：比如你试图装 torch 却没指定 cu118 后缀，pip 会遍历所有平台版本直到超时；或者 requirements.txt 里混了已弃用的包名。所以看到超时，先盯住那条正在装的包名，而不是无脑调参数。
