现象
内网服务器装 torCh,pip install 跑到一半卡住,最后抛 ReadTimeoutError: HTTPSConnectionPool(host='pypi.org', port=443): Read timed out。换个大包又重复出现,重试十几次只成功过一次,日志里的下载进度每次都停在同一层。
原因
默认源在境外,单个包动辄几百兆,连接一抖就超过默认的 15 秒读超时;公司网络还可能有代理或防火墙限制并发连接。pip 只在整段下载失败后重试,不会断点续传,所以大包几乎必挂。
解决步骤
第一步,换国内镜像并显式加大超时与重试次数。先把单次安装跑通,再考虑固化配置。
python -m pip install torch \
-i https://pypi.tuna.tsinghua.edu.cn/simple \
--timeout 120 --retries 5
第二步,把配置固化下来。在 ~/.config/pip/pip.conf 或 %APPDATA%\pip\pip.ini 里写 global.index-url 和 timeout,之后所有安装都会走镜像。内网机器没有外网出口时,用 pip download 在能上网的机器上下好 whl,再拷贝过去离线安装。
第三步,代理环境补上环境变量。export HTTPS_PROXY 指向公司代理,或给 pip 加 --proxy 参数;确认镜像站可达再执行,别让请求一直在超时里排队。
验证
同一条命令连续装两次大包都能在几分钟内完成,pip config list 能看到 index-url 和 timeout 已生效,说明链路稳定。
小结
超时的根因是源远、包大、超时短。换源加长超时并配置成默认值,比反复重试更有效。
