Python 安装某个库,出现 Read_Time_out 错误,那么如何配置 “国内镜像源”呢?

雪夜
发布: 2025-09-03 08:59:14
原创
1010人浏览过

问题来源

今天在使用 pip install xlutils 安装 xlutils 包的时候,一直出现如下错误:

代码语言:javascript代码运行次数:0运行复制
<pre class="brush:php;toolbar:false;">ReadTimeoutError: HTTPSConnectionPool(host=‘files.pythonhosted.org’, port=443): Read timed out.
登录后复制
Python 安装某个库,出现 Read_Time_out 错误,那么如何配置 “国内镜像源”呢?

可能原因是由于,使用这种方式安装某些库的时候,会从国外的镜像源去下载,最终导致反应超时的情况发生。

太扎心了,有时候想要使用某个库,却一直下载不下来,着急没办法呀!如何解决呢?

配置国内镜像源

这里在正式讲述知识点之前,先给大家介绍几个常用的镜像源,不知道也没关系,了解就行。常用国内的常用镜像源列表如下:

清华源:https://pypi.tuna.tsinghua.edu.cn/simple/阿里云:http://mirrors.aliyun.com/pypi/simple/清华大学:https://pypi.tuna.tsinghua.edu.cn/simple/① 临时使用“国内镜像源”

如果说,你不想配置镜像源,只是想要临时使用国内镜像源,安装某个库而已。此时,你可以输入以下命令:

立即学习Python免费学习笔记(深入)”;

代码语言:javascript代码运行次数:0运行复制
<pre class="brush:php;toolbar:false;"># 直接下载,速度慢pip install pandas # 使用国内镜像源下载,速度快pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple/
登录后复制

注意上述两者的区别,只不过使用了 -i 参数,来指定镜像地址而已。

这种方法是一次性的,下载你如果想要下载其它的库,需要一直这样操作。

② 永久使用“国内镜像源”

能不能有一种一劳永逸的方法,解决这个问题呢?这就是接下来要讲述的,我们以 linuxwindows 平台,分别为大家讲述。

对于 linux 平台:

首先,使用如下命令创建一个目录 pip,并在目录下创建一个 pip.conf 文件。

Trae国内版
Trae国内版

国内首款AI原生IDE,专为中国开发者打造

Trae国内版 815
查看详情 Trae国内版
代码语言:javascript代码运行次数:0运行复制
<pre class="brush:php;toolbar:false;"># 创建目录mkdir ~/.pip# 切换到该目录下cd ~/.pip# 在该目录下,创建一个文件touch pip.conf
登录后复制

接着,使用如下命令打开 pip.conf 文件。

代码语言:javascript代码运行次数:0运行复制
<pre class="brush:php;toolbar:false;">sudo vi ~/.pip/pip.conf
登录后复制

然后,朝其中写入如下内容。

代码语言:javascript代码运行次数:0运行复制
<pre class="brush:php;toolbar:false;">[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple[install]trusted-host = https://pypi.tuna.tsinghua.edu.cn  # trusted-host 此参数是为了避免麻烦,否则使用的时候可能会提示不受信任
登录后复制

然后,保存退出即可。如果大家对 linux 命令不熟悉的话,自行下去学习一下哦。

对于 windows 平台:

首先,需要在 user 用户目录下,创建一个新的文件夹 pip;

Python 安装某个库,出现 Read_Time_out 错误,那么如何配置 “国内镜像源”呢?

接着,在 pip 文件夹下,创建一个 pip.txt 文本文件,接着将后缀由 “txt” 改为 “ini”;

Python 安装某个库,出现 Read_Time_out 错误,那么如何配置 “国内镜像源”呢?

最后,朝其中写入如下内容即可;

代码语言:javascript代码运行次数:0运行复制
<pre class="brush:php;toolbar:false;">[global]index-url = https://pypi.tuna.tsinghua.edu.cn/simple[install]trusted-host = pypi.tuna.tsinghua.edu.cn
登录后复制

修改完成后,保存即可。

再次启动 cmd,使用 " pip install 库名 " 安装相关库,即可默认使用国内源下载。

Python 安装某个库,出现 Read_Time_out 错误,那么如何配置 “国内镜像源”呢?

End

以上就是Python 安装某个库,出现 Read_Time_out 错误,那么如何配置 “国内镜像源”呢?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号