最有效解法是换国内镜像源并增加超时时间：临时用pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --timeout 6000；永久配置pip.ini或pip.conf文件；网络极差时离线下载.whl安装；同时升级pip、清缓存、检查代理与平台匹配。
pip install 超时失败（ReadTimeoutError）怎么救
直接原因就是 pip 等不到服务器响应，常见报错是 ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out。这不是你代码写错了，是网络链路卡在了“发请求→等回包”这一步。
最有效、最优先尝试的解法是换源 + 加超时：用国内镜像源降低延迟，再把默认 15 秒的等待时间拉长到足够下载完包。
- 临时生效（推荐先试）：
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple --timeout 6000 -
--timeout单位是毫秒，6000= 6 秒；大包如torch建议设12000或更高 - 如果提示
trusted-host报错，加一句--trusted-host pypi.tuna.tsinghua.edu.cn - 清华源目前同步最全、稳定性最高，阿里源和中科大源可作备选
永久配置国内源，避免每次敲一堆参数
Windows 用户别去改环境变量或重装 Python，直接在用户目录下建配置文件就行——这是真正一劳永逸的做法，且不会影响系统级 Python。
- 路径：
C:\Users\你的用户名\pip\pip.ini（注意是pip文件夹，不是pip文件） - 文件内容必须严格如下（少一行或多空格都可能失效）：
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn timeout = 6000
- Linux/macOS 用户对应路径是
~/.pip/pip.conf，内容格式一致 - 改完不用重启终端，下次
pip install就自动生效
网络极差时，离线安装是最后防线
当换源+调超时仍失败（比如公司内网完全封外网），就得绕过网络，手动把包拖进来装。
- 去
https://pypi.tuna.tsinghua.edu.cn/simple/包名/页面找对应平台的.whl文件（例如numpy-1.26.4-cp39-cp39-win_amd64.whl） - 注意核对三要素：
cp39表示 Python 3.9，win_amd64是 Windows 64 位，manylinux才是 Linux - 下载后执行：
pip install numpy-1.26.4-cp39-cp39-win_amd64.whl（路径支持相对/绝对） - 依赖缺失？用
pip download 包名 --no-deps --platform win_amd64 --python-version 39 --only-binary=all一次性下齐所有 wheel
别忽略 pip 自身版本和缓存干扰
旧版 pip（比如 20.x 以前）对 HTTPS 和镜像源的支持不完整，容易在设置好源之后依然走官方域名；同时缓存损坏也会导致反复失败。
- 先升级 pip：
python -m pip install --upgrade pip（强制走模块方式，避开 PATH 冲突） - 清空 pip 缓存：
pip cache purge（缓存位置可通过pip cache info查看） - 确认当前生效源：
pip config list或pip debug -v，看到index-url是国内地址才算成功 - 如果用了代理但没配好，反而会让国内源也变慢，此时应先
set HTTP_PROXY=（Windows）或unset HTTP_PROXY（Linux/macOS）清掉代理
--timeout 12000 能扛住绝大多数办公/家庭弱网场景；剩下那 10%，基本是 Python 版本不匹配或 wheel 平台标识不对——这时候看报错里带的 cp39、win32 这类字符串，比反复重试更省时间。 
