pip install超时是不是要换国内镜像?

浅枫小哥_5643

浅枫小哥_5643

2026-05-15

903人浏览

原创

换用国内镜像源是解决pip安装超时问题的直接高效方法,包括临时指定源、永久配置windows/linux/macos全局源、pip config命令设置及延长超时阈值五种方案。

pip install超时是不是要换国内镜像?

如果您执行 pip install 命令时反复出现“Read timed out”“Connection to pypi.org timed out”或长时间卡在“Collecting package”阶段,则大概率不是本地网络中断,而是 pip 仍在尝试连接远在境外的默认源 https://pypi.org/simple——该地址在国内解析慢、TLS握手延迟高、传输易丢包。换用国内镜像源是直接且高成功率的应对方式。以下是多种可行方案:

一、临时指定镜像源(单次安装生效)

此方法不修改任何配置,适用于快速验证或仅安装某一个包,避免因镜像配置错误导致后续异常。命令中显式声明镜像地址与可信主机,绕过证书校验拦截。

1、在终端中输入完整命令,注意末尾空格及斜杠格式:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn requests

2、若需安装其他库(如 numpy),将末尾 “requests” 替换为对应包名即可

3、可替换为其他国内镜像地址,例如阿里云源:pip install -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com 包名

二、永久配置全局镜像源(Windows系统)

此方法通过创建标准 pip 配置文件,使所有后续 pip install 命令自动使用指定镜像,无需重复添加参数。关键在于路径与文件名必须严格符合 pip 的 Windows 查找规则。

1、按下 Win + E 打开文件资源管理器,在地址栏粘贴并回车:%APPDATA%

2、进入该目录后,检查是否存在名为 pip 的文件夹;如无,则右键 → 新建 → 文件夹,并命名为 pip

3、进入 pip 文件夹,右键 → 新建 → 文本文档,打开后粘贴以下两行内容:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn

4、将该文本文档重命名为 pip.ini,操作时需确保已开启“显示文件扩展名”,并把 .txt 后缀完全删除

三、永久配置全局镜像源(Linux/macOS系统)

此方法通过在用户主目录下建立标准 pip 配置路径和文件,实现所有虚拟环境与系统级 pip 调用统一走国内源。配置位置与权限需准确,否则 pip 将忽略该文件。

1、在终端中执行创建目录命令:mkdir -p ~/.pip

2、执行写入配置命令:echo "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple/\ntrusted-host = pypi.tuna.tsinghua.edu.cn" > ~/.pip/pip.conf

3、确认文件生成成功:运行 cat ~/.pip/pip.conf,应完整显示上述三行内容

4、如当前用户为 root 或使用 sudo 运行 pip,还需为 root 用户单独配置:将相同内容写入 /root/.pip/pip.conf

四、使用 pip config 命令行工具设置(跨平台通用)

此方法依赖 pip 21.0+ 版本内置的配置管理子命令,不涉及手动编辑文件,适合对文件系统路径不熟悉或需脚本化部署的场景。命令会自动定位并更新正确的配置文件位置。

1、在终端中运行:pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/

2、紧接着运行:pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

3、验证是否生效:运行 pip config list,输出中应包含刚设置的两项

4、若提示 “No such key”,说明 pip 版本过低,需先执行 python -m pip install --upgrade pip

五、延长超时阈值作为辅助手段

当镜像源本身响应偶发波动(如 CDN 节点瞬时拥塞),单纯换源可能仍短暂失败。此时可同步提升 pip 的连接与读取等待上限,避免因短时延迟被误判为超时。

1、临时延长单次安装超时:在安装命令末尾添加 --default-timeout=100,例如 pip install requests --default-timeout=100

2、永久设置超时值:运行 pip config set global.timeout 100

3、注意 timeout 单位为秒,数值不宜超过 120,过高可能导致故障响应迟滞

4、该设置需与镜像源配置共存才有效;若仅设 timeout 而未换源,仍会持续连接国外服务器

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

2490

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

5723

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

7262

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

3507

16

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

80

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

40

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

20

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

20

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

40

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.2万人学习