Linux下怎么配置pip源为国内镜像加速下载

大丽酱_7735

大丽酱_7735

2026-09-22

610人浏览

原创

推荐pip config set命令永久配置,因其是pip≥21.3内置机制,自动处理路径、权限与格式校验;手动建pip.conf易因路径错误、bom编码或挂载异常失效,且阿里云源在2026年延迟更低、同步更稳,需配对应trusted-host防https证书校验失败。

linux下怎么配置pip源为国内镜像加速下载

直接用 pip config set 命令永久配置,是当前(2026 年)Linux 下最可靠、最省事的方式,不用手动建目录、不担心编码或权限问题。

为什么推荐 pip config set 而不是手动改 pip.conf

因为 pip configpip ≥ 21.3 内置的配置管理机制,能自动处理路径、权限和格式校验。而手动创建 ~/.pip/pip.conf 容易出错:比如文件路径写错(~/.config/pip/pip.conf~/.pip/pip.conf 都可能被读取,但优先级不同)、UTF-8-BOM 导致解析失败、甚至因用户主目录挂载方式异常导致配置不生效。命令行方式绕过了所有这些不确定性。

  • pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
  • pip config set global.trusted-host mirrors.aliyun.com

阿里云源在 2026 年多数地区延迟更低、同步更稳;清华源虽常用,但近期偶发目录结构变更引发 404,尤其对带命名空间的包(如 torchnightly 分支)兼容性略差。

trusted-host 必须配,否则 HTTPS 会报 CertificateError

国内镜像源启用 HTTPS 后,pip 默认会校验证书链。但部分镜像域名(如 mirrors.aliyun.com)的证书由中间 CA 签发,老版本 OpenSSL 或某些定制系统环境可能无法完整验证。不加 trusted-host 就会卡在 CertificateError: hostname 'mirrors.aliyun.com' doesn't match...

CRM Pipeline Manager
CRM Pipeline Manager

通过自然语言管理销售管道——添加潜在客户、更新阶段、记录互动、设置提醒、生成报告,无需复杂的CRM软件。

下载
  • 必须和 index-url 的域名保持一致(注意不含 https:// 和路径)
  • 如果换用清华源,对应写 pypi.tuna.tsinghua.edu.cn,不是 https://pypi.tuna.tsinghua.edu.cn
  • 多个 host 可追加多条:pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

验证配置是否真正生效

别只信 pip config list 的输出——它只显示配置项,不保证运行时实际加载。最准的验证方式是看安装时的提示行:

pip install requests

成功时终端第一行应为:

Looking in indexes: https://mirrors.aliyun.com/pypi/simple/

如果还是出现 https://pypi.org/simple,说明配置没被读取,常见原因有:

  • 执行 pip config 时用了 sudo,导致写入了 root 用户的配置,而你日常用普通用户运行 pip
  • 系统存在多个 pip 配置层级(global / user / site),低优先级配置覆盖了高优先级的
  • 当前 Python 环境是 virtualenv 或 conda 创建的,且 pip 被重新封装过(如某些 Anaconda 版本自带 pip 行为异常)

复杂点在于:镜像源不是“设完就一劳永逸”的开关。有些包(尤其是含 C 扩展的)会从 index-url 拿到 wheel 地址后,再单独发起 HTTP 请求下载二进制文件——这时如果该镜像站没同步对应平台的 wheel,pip 会悄悄 fallback 到官方源,导致部分文件仍慢。所以选源不能只看速度,还得看 wheel 覆盖率和更新及时性。

相关文章

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

2370

5

更新pip版本
更新pip版本

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

2024.12.20

5463

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

6982

11

python升级pip
python升级pip

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

2025.07.23

3327

16

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

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

2023.06.21

3590

4

如何安装LINUX
如何安装LINUX

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

2023.06.29

3133

10

linux find
linux find

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

2023.06.30

2173

5

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

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

2023.07.05

5190

7

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

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

2023.07.06

4862

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

CLion 远程开发实战
CLion 远程开发实战

共0课时 | 0人学习