默认源易超时因连接海外files.pythonhosted.org，受物理距离、链路不稳定及防火墙干扰；临时用-i参数换清华源可快速验证，永久配置pip.ini或pip.conf并设timeout=6000可彻底解决。

直接换国内镜像源，90% 的 Read timed out 问题当场消失。

为什么默认源容易超时

pip 默认连接 files.pythonhosted.org，服务器在海外。物理距离远 + 中间链路不稳定（尤其 ISP 限速、DNS 污染、企业防火墙干扰 TLS 握手），导致 TCP 连接建立慢、HTTPS 响应卡顿，15 秒默认超时根本不够用。

这不是你网速差，而是路径本身不可靠。哪怕 ping 通，ReadTimeoutError 仍会高频出现。

临时生效：单次安装加 -i 参数

最快速验证是否是源的问题：

• pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple（清华源，推荐首选）
• pip install requests -i https://pypi.douban.com/simple（豆瓣源，备用）
• pip install requests -i https://mirrors.aliyun.com/pypi/simple/（阿里云源）

注意：--trusted-host 在 HTTPS 镜像下通常不需要；若提示证书问题，才追加 --trusted-host pypi.tuna.tsinghua.edu.cn。

Webnovel Serial Pipeline

构建并发布在 Quartz 平台上的韩语网络小说连载（草稿→封面→webp→章节 md→lint→发布），使用 Nano Banana Pro + ffmpeg。

下载

永久生效：改 pip 配置文件

避免每次敲一堆参数，直接固化配置：

• Windows：在 C:\Users\你的用户名\pip\pip.ini 中写入：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
timeout = 6000

• macOS / Linux：在 ~/.pip/pip.conf 或 ~/.config/pip/pip.conf 中写入相同内容
• 如果文件或目录不存在，手动创建即可

改完后无需重启终端，下次 pip install 就自动走清华源，且超时阈值拉到 6000 秒（100 分钟），彻底避开“卡住又失败”的循环。

还超时？得看是不是其他环节堵住了

换源后仍报 ReadTimeoutError，说明问题不在源本身，要排查更底层的干扰：

• 代理开着没关：检查系统或终端是否设置了 http_proxy/https_proxy 环境变量，临时 unset http_proxy https_proxy 再试
• 杀毒软件或防火墙拦截了 pip 的 HTTPS 请求（尤其某些国产安全软件），可临时禁用测试
• 公司内网做了 DPI 深度检测，导致 TLS 握手被重置 —— 这时换源无效，需联系 IT 开白名单或改用 conda install
• 缓存损坏：删掉 ~/.cache/pip/（macOS/Linux）或 %LOCALAPPDATA%\pip\Cache（Windows），再重试

真正难搞的不是超时本身，而是你以为换了源就万事大吉，结果发现是本地网络策略在背后卡脖子 —— 这类问题不会报错信息，只会静默失败或随机中断。