一、问题/场景描述
在使用pip安装Python依赖包时，开发者常遇到连接超时错误。典型表现为：执行pip install命令后，长时间无响应，最终输出类似
ReadTimeoutError: HTTPSConnectionPool(host='pypi.org', port=443): Read timed out.或
WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectTimeoutError(...)'这类错误。该问题在首次搭建Python开发环境或部署项目时尤为常见，严重影响开发效率。
二、原因分析
Python依赖安装连接超时的根本原因在于网络层面。具体包括：
1. 默认源服务器响应慢：pip默认从官方PyPI源（pypi.org）下载包，该服务器位于国外，国内访问受网络延迟和带宽限制，在高并发或高峰时段容易超时。
2. DNS解析问题：部分网络环境下，DNS解析速度慢或无法正确解析PyPI域名，导致连接建立失败。
3. 防火墙或代理限制：企业内网或某些云服务器环境可能阻断了对国外源站的直接访问。
4. 包体积过大或网络不稳定：下载大型包（如numpy、tensorflow）时，因网络波动导致传输中断，触发超时重试机制。
三、详细解决步骤
步骤1：临时使用国内镜像源
最直接的解决方案是临时指定国内镜像源，如阿里云、清华大学、豆瓣等。执行命令时添加
-i参数：
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple常用国内镜像源地址：
- 清华大学：
https://pypi.tuna.tsinghua.edu.cn/simple - 阿里云：
https://mirrors.aliyun.com/pypi/simple - 豆瓣：
https://pypi.doubanio.com/simple
步骤2：永久配置镜像源
为避免每次手动指定，可修改pip配置文件。在Linux/macOS中，执行：
mkdir -p ~/.pip
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF在Windows中，配置文件路径为
%USERPROFILE%pippip.ini，内容同上。
步骤3：增加超时时间
若网络波动较大，可延长默认超时时间（默认15秒）。使用
--default-timeout参数：
pip install requests --default-timeout=100或结合镜像源：
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple --default-timeout=100步骤4：使用代理
若环境必须通过代理访问外网，设置HTTP/HTTPS代理：
pip install flask --proxy http://127.0.0.1:1080或在系统环境变量中设置：
export http_proxy=http://127.0.0.1:1080
export https_proxy=http://127.0.0.1:1080步骤5：升级pip并清除缓存
旧版本pip可能存在连接问题，升级pip并清除缓存：
pip install --upgrade pip
pip cache purge四、注意事项
1. 使用镜像源时，注意其同步频率（通常为每日同步），最新发布的包可能延迟数小时。若需安装最新版本，建议使用官方源并配合代理。
2. 配置永久镜像源后，若需临时使用官方源，可用
--no-index参数忽略配置。
3. 在Docker容器或CI/CD环境中，建议在Dockerfile或构建脚本中预先配置镜像源，避免每次构建时超时。
五、适用环境
本文适用于主流Linux发行版（如Ubuntu 22.04、CentOS 7）、macOS及Windows系统，Python版本3.6及以上，pip版本20.x及以上。