linux怎么配置pip使用国内镜像源加速模块安装

陌浩大大_6329

陌浩大大_6329

2026-11-22

563人浏览

原创

推荐用pip config命令一键永久配置国内镜像源,执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple和pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn,自动创建并写入~/.pip/pip.conf。

linux怎么配置pip使用国内镜像源加速模块安装

在国内使用pip安装Python模块时,经常出现下载缓慢、连接超时甚至中断失败的问题,根本原因是默认PyPI源服务器位于海外,网络路径长且不稳定。直接配置Linux系统下的pip国内镜像源,能立即将安装速度从几KB/s提升至数MB/s,且无需重启终端或重装Python。

用pip config命令一键永久配置

这是最推荐的方式,命令自动创建目录、写入配置、处理权限,适合所有主流Linux发行版(Ubuntu/CentOS/Debian等)。

在终端中依次执行以下两条命令:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

这两条命令会自动生成 ~/.pip/pip.conf 文件并写入正确内容。如果提示 【PermissionError: [Errno 13] Permission denied】,说明当前用户无权写入 ~/.pip 目录,请先运行 mkdir -p ~/.pip 确保目录存在且属主为当前用户。

手动创建并编辑pip.conf文件

当 pip config 命令不可用(如旧版pip

第一步:打开终端,执行 mkdir -p ~/.pip 创建配置目录

第二步:用nano编辑器新建并编辑配置文件:nano ~/.pip/pip.conf

第三步:输入以下三行内容(注意格式严格,不能有多余空格或中文标点):

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

第四步:按 Ctrl+O 保存 → 回车确认 → Ctrl+X 退出。这一步漏掉保存会导致配置完全不生效。

oo-linux-do
oo-linux-do

Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。

下载

验证镜像源是否生效

方法一:查看当前配置

pip config list

若输出中包含 global.index-url='https://mirrors.aliyun.com/pypi/simple/',说明已成功写入。

方法二:触发一次真实安装

pip install -v requests | grep "Looking in indexes"

该命令会显示pip实际查询的索引地址,输出中必须出现你设置的国内域名,例如 pypi.tuna.tsinghua.edu.cn,而非 pypi.org。

方法三:检查网络请求路径(关键验证)

执行 pip install --dry-run numpy 2>&1 | grep -i "https.*simple"

如果返回的是国内镜像URL而非 pypi.org/simple,则证明流量已走国内节点,配置完成。

相关文章

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

3790

5

更新pip版本
更新pip版本

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

2024.12.20

8583

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

10342

11

python升级pip
python升级pip

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

2025.07.23

5507

16

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

4690

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3913

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

3293

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

8170

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

7802

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
安装 Xdebug 并配置 phpstorm
安装 Xdebug 并配置 phpstorm

共1课时 | 218人学习

Navicat 18 Linux 用户手册
Navicat 18 Linux 用户手册

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习