Python开发技巧：解决pip安装包时的ReadTimeoutError问题

问题描述

当使用 pip 工具安装 Python 包时，如果网络连接不稳定或服务器响应缓慢，可能会遇到超时错误（ReadTimeoutError）。这种情况下，pip 会因为等待服务器响应的时间过长而中断操作。

解决方案

针对上述问题，有两种常见的解决方法：

1. 更改配置文件

可以通过修改 pip 的配置文件来增加超时时间或更换更快的源。具体步骤如下：

在用户主目录下的 .pip 文件夹中（如果没有该文件夹需要手动创建），创建或编辑 pip.conf 文件，添加以下内容：

[global]
timeout = 6000
index-url = https://pypi.douban.com/simple/
[install]
use-mirrors = true
mirrors = https://pypi.douban.com/simple/
trusted-host = pypi.douban.com


这种方法虽然简单有效，但部分用户担心可能存在安全风险，因此推荐使用第二种方法。

2. 命令行指定源

另一种更为灵活的方法是在执行 pip install 命令时直接指定一个快速的镜像源。例如：

pip install -i https://pypi.douban.com/simple package_name
pip install -i https://pypi.douban.com/simple --trusted-host pypi.douban.com package_name
pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple --upgrade package_name


通过这种方式，可以在不修改全局配置的情况下，临时使用特定的镜像源进行包的安装。

参考资料

- 如何使用国内镜像加速 Python 包的下载
- 解决 pip 安装外部包时的超时问题
- 遇到 pip 安装 Python 库频繁超时的处理办法