Python使用pip通过命令设置国内镜像源的三种方式

 更新时间:2025年08月22日 09:38:39   作者:学亮编程手记  
在使用 pip 安装 Python 模块时,默认的国外镜像源可能会导致下载速度缓慢甚至超时,为了解决这个问题,可以使用国内的镜像源来加速下载,以下是常用的国内镜像源以及临时和永久的配置方法,需要的朋友可以参考下

好的,在 Python 中使用 pip 通过命令设置国内镜像源主要有两种方式:临时使用永久设置

国内常用的镜像源有:

  • 清华 tuna: https://pypi.tuna.tsinghua.edu.cn/simple
  • 阿里云: http://mirrors.aliyun.com/pypi/simple/
  • 中国科技大学: https://pypi.mirrors.ustc.edu.cn/simple/
  • 豆瓣: http://pypi.douban.com/simple/
  • 华为云: https://repo.huaweicloud.com/repository/pypi/simple/

方法一:临时使用(单次安装)

在安装特定的 Python 包时,直接在 pip install 命令后面加上 -i--index-url 参数来指定镜像源。

命令格式:

pip install -i <镜像源URL> <包名>

示例:

使用清华源安装 requests

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests

注意: 如果镜像源是 HTTPS 但证书有问题,可以加上 --trusted-host 参数。

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests --trusted-host pypi.tuna.tsinghua.edu.cn

方法二:永久设置(一劳永逸)

这种方法只需要配置一次,之后所有的 pip install 命令都会默认使用你设置的镜像源。

Windows 系统

  • 在用户目录下(如 C:\Users\你的用户名\)创建一个名为 pip 的文件夹。
  • 在这个 pip 文件夹里,创建一个名为 pip.ini 的文件。
  • 用记事本等文本编辑器打开 pip.ini,输入以下内容并保存:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
  • index-url: 指定镜像源地址。
  • trusted-host: 添加信任的主机,防止 HTTPS 证书验证错误。

Linux 或 macOS 系统

在用户根目录(~)下创建 .pip 文件夹(如果不存在的话)。

mkdir ~/.pip

创建或修改配置文件 ~/.pip/pip.conf

nano ~/.pip/pip.conf

输入与 Windows 相同的配置内容并保存。

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

验证配置是否生效:

配置完成后,你可以直接运行 pip install <某个包名>,观察下载速度是否来自你设置的国内源。你也可以通过运行 pip config list 来查看当前的配置。

pip config list

这个命令会输出当前生效的所有 pip 配置。

方法三:使用 pip config 命令设置(推荐)

这是最现代和推荐的方法,无需手动创建文件和文件夹,直接用命令修改配置。

设置全局镜像源:

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

设置信任的主机(如果需要):

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

查看所有配置:

pip config list

删除某个配置(如果想恢复默认):

# 例如删除index-url配置
pip config unset global.index-url

总结

方法优点缺点适用场景
临时使用 (-i)灵活,不影响其他项目每次都要输入长命令偶尔使用特定源
永久设置 (配置文件)一劳永逸,配置一次即可需要手动创建文件个人电脑,希望默认加速
pip config 命令最方便快捷,自动处理文件所有场景,强烈推荐

推荐直接使用 pip config set global.index-url ... 命令进行设置,这是最简洁有效的方式。

到此这篇关于Python使用pip通过命令设置国内镜像源的三种方式的文章就介绍到这了,更多相关Python pip设置国内镜像源内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • python分布式系统Celery安装使用实例讲解

    python分布式系统Celery安装使用实例讲解

    这篇文章主要为大家介绍了python分布式系统Celery安装使用实例讲解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-12-12
  • Agent开发核心技术解析以及现代Agent架构设计

    Agent开发核心技术解析以及现代Agent架构设计

    在人工智能领域,Agent并非一个全新的概念,但在大模型时代,它被赋予了全新的生命力,简单来说,Agent是一个能够自主感知环境、理解任务、制定计划、调用工具并完成目标的智能实体,它不仅仅是与你对话的聊天机器人,更是能够代理你完成复杂工作的"数字员工"
    2025-12-12
  • pandas 相关性和正态性分析的实践

    pandas 相关性和正态性分析的实践

    当我们谈论正态性(Normality)和相关性(Correlation)时,我们实际上在尝试理解数据的分布模式和不同变量之间的关系,本文就来介绍一下pandas 相关性和正态性的实践,感兴趣的可以了解一下
    2024-07-07
  • pytorch中的优化器optimizer.param_groups用法

    pytorch中的优化器optimizer.param_groups用法

    这篇文章主要介绍了pytorch中的优化器optimizer.param_groups用法,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-05-05
  • python实现超简单的视频对象提取功能

    python实现超简单的视频对象提取功能

    这篇文章主要给大家介绍了关于利用python实现超简单的视频对象提取功能的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2018-06-06
  • 如何利用Opencv实现图像的加密解密

    如何利用Opencv实现图像的加密解密

    一般情况下,图像的加密和解密过程是通过按位异或运算实现的,下面这篇文章主要给大家介绍了关于如何利用Opencv实现图像加密解密的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2021-10-10
  • python创建虚拟环境的3种方式

    python创建虚拟环境的3种方式

    在Python开发中,主要有三种创建虚拟环境的方式,包括conda、pyenv+pyenv-virtualenv和venv,它们各有特点和适用场景,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
    2026-02-02
  • python根据多个文件名批量查找文件

    python根据多个文件名批量查找文件

    这篇文章主要为大家详细介绍了python根据多个文件名批量查找文件,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-08-08
  • Python获取Linux系统下的本机IP地址代码分享

    Python获取Linux系统下的本机IP地址代码分享

    这篇文章主要介绍了Python获取Linux系统下的本机IP地址代码分享,本文直接给出实现代码,可以获取到eth0等网卡的IP地址,需要的朋友可以参考下
    2014-11-11
  • python之np.argmax()及对axis=0或者1的理解

    python之np.argmax()及对axis=0或者1的理解

    这篇文章主要介绍了python之np.argmax()及对axis=0或者1的理解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-06-06

最新评论