讲师中心 微信公众号
AI工具推荐 视频效率加速

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

大丽酱_7735

大丽酱_7735

发布时间:2026-09-22 07:36:26

|

610人浏览过

|

来源于php中文网

原创

推荐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 config 是 pip ≥ 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 覆盖率和更新及时性。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

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

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

2350

2023.10.09

更新pip版本
更新pip版本

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

5463

2024.12.20

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

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

6982

2024.12.23

python升级pip
python升级pip

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

3327

2025.07.23

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

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

3590

2023.06.21

如何安装LINUX
如何安装LINUX

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

3133

2023.06.29

linux find
linux find

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

2173

2023.06.30

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

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

5170

2023.07.05

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

0

2026.09.21

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ubuntu官方总文档
ubuntu官方总文档

共0课时 | 0人学习

小皮面板使用视频教程
小皮面板使用视频教程

共30课时 | 21.5万人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn