超时失败基本是卡在pypi官方源，换清华或阿里等国内镜像源可解决95%问题；临时换源用pip install -i加url，永久换源推荐pip config命令或编辑pip.ini/pip.conf配置文件并设timeout=600。
超时失败基本就是网络卡在 PyPI 官方源上，换国内镜像源能解决 95% 的情况，优先用清华源或阿里源。
临时换源：一条命令搞定单次安装
不用改配置、不碰文件，适合快速验证或只装一次的场景。清华源和阿里源都稳定，推荐优先试清华源：
- 执行
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 如果报
ReadTimeoutError或提示证书问题，追加--trusted-host pypi.tuna.tsinghua.edu.cn - 阿里源地址是
https://mirrors.aliyun.com/pypi/simple/，用法一样，可互换测试 - 注意 URL 末尾必须带
/simple/，少这个路径会 404
永久换源：写入 pip 配置文件（用户级）
避免每次敲长命令，且只影响当前用户，最安全常用的方式：
- Windows：在
%APPDATA%\pip\pip.ini中写入：
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn timeout = 600
- macOS / Linux：在
~/.pip/pip.conf中写相同内容 -
timeout = 600把默认 15 秒拉到 10 分钟，对大包（如torch）很关键 - 写完后新开终端生效，不用重启系统
pip config 命令设置（推荐给命令行熟练者）
比手动编辑文件更可控，支持层级管理，且能查错：
- 先运行
pip config list看当前有没有冲突配置 - 设清华源：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ - 加可信主机：
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn - 若想删掉某项配置，用
pip config unset global.index-url - 注意：
pip config在旧版 pip（python -m pip install --upgrade pip
换源后仍失败？重点检查这三处
镜像源不是万能药，下面这些点经常被忽略：
- Python 和 pip 版本太老，比如 pip 9.x 不支持
trusted-host写法，必须升级：python -m pip install --upgrade pip - 公司内网或校园网开了代理，但 pip 没配代理，此时换源无效，得加
--proxy http://user:pass@host:port - 某些库（如
twisted、pywin32）含 C 扩展，需本地编译环境，单纯换源不能绕过，得装 Visual Studio Build Tools 或用预编译.whl
镜像源只是把下载路径换近了，但 pip 自身版本、网络代理、编译依赖这些底层条件没调好，照样会卡住——尤其在批量部署或 CI 环境里，别只盯 -i 参数。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
