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中的zip()与*zip()函数详解

    浅谈Python中的zip()与*zip()函数详解

    这篇文章主要介绍了浅谈Python中的zip()与*zip()函数详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-02-02
  • Python入门教程(二十九)Python的RegEx正则表达式

    Python入门教程(二十九)Python的RegEx正则表达式

    这篇文章主要介绍了Python入门教程(二十九)Python的RegEx,RegEx 或正则表达式是形成搜索模式的字符序列。RegEx 可用于检查字符串是否包含指定的搜索模式,需要的朋友可以参考下
    2023-04-04
  • python 类中函数名前后加下划线的具体使用

    python 类中函数名前后加下划线的具体使用

    在Python编程语言中,函数名前后有下划线是一种常见的命名约定,,被广泛应用于类中的函数,本文将介绍下划线命名风格的由来、使用场景以及如何正确应用它,感兴趣的可以了解一下
    2024-01-01
  • Python 编程速成(推荐)

    Python 编程速成(推荐)

    这篇文章主要介绍了Python 编程速成,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-04-04
  • 零基础写python爬虫之爬虫的定义及URL构成

    零基础写python爬虫之爬虫的定义及URL构成

    俗话说工欲善其事必先利其器,作为本系列文章的第一篇,我们同样也需要先利其器,先把爬虫的定义以及写爬虫所需要的基础知识先介绍给大家。
    2014-11-11
  • 在PyCharm中找不到Conda创建的环境的解决方法

    在PyCharm中找不到Conda创建的环境的解决方法

    本文主要介绍了在PyCharm中找不到Conda创建的环境的解决方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • 基于Python实现Excel转Markdown表格

    基于Python实现Excel转Markdown表格

    Markdown(也简称md)作为一种轻量级标记语言,因其易写易读,效果美观大方,不仅被众多网站使用,也是程序员们做笔记、写文档的首选。本文将利用Python实现Excel转Markdown表格,感兴趣的可以了解一下
    2022-04-04
  • Python常见数据结构之栈与队列用法示例

    Python常见数据结构之栈与队列用法示例

    这篇文章主要介绍了Python常见数据结构之栈与队列用法,结合实例形式简单介绍了数据结构中栈与队列的概念、功能及简单使用技巧,需要的朋友可以参考下
    2019-01-01
  • Python自动化按日期分割日志的多种方法

    Python自动化按日期分割日志的多种方法

    在开发和运维Python应用程序时,日志管理是至关重要的,不仅帮助我们调试问题,还能用于监控和性能分析,下面就跟随小编一起学习一下多种自动化按日期分割日志的方法吧
    2025-04-04
  • 简单介绍Python的Django框架的dj-scaffold项目

    简单介绍Python的Django框架的dj-scaffold项目

    这篇文章主要介绍了简单介绍Python的Django框架的dj-scaffold项目,用于辅助Django框架的目录设置,需要的朋友可以参考下
    2015-05-05

最新评论