Python pip配置国内镜像源加速下载

顾言
顾言
发布时间:2026-10-13| 5人浏览过
原创

本文详细介绍Python pip配置国内镜像源的方法,解决下载慢或无法连接的问题。涵盖临时使用镜像安装命令,以及Linux和Windows平台下永久配置pip.conf或pip.ini文件的步骤,推荐清华大学、阿里云等常用镜像,帮助开发者提升包安装效率。

Python pip配置国内镜像源教程

在使用Python通过pip安装第三方库时,默认源为https://pypi.org/,这往往导致下载速度缓慢甚至连接失败。为解决这一问题,配置国内镜像源显得尤为关键。经过实践总结,以下方案可有效提升下载体验。

首先通过对比图展示不同源下的下载速度差异:

图1:国外官方源下载效果

图2:国内镜像源下载效果

推荐几个稳定且速度较快的国内镜像站,其中个人推荐使用清华大学PyPI镜像站(https://mirrors.tuna.tsinghua.edu.cn/help/pypi/),该源每五分钟同步一次,资源齐全且下载速度优异。

清华大学:https://pypi.tuna.tsinghua.edu.cn/simple 阿里云:http://mirrors.aliyun.com/pypi/simple/ 豆瓣:http://pypi.douban.com/simple/

接下来,针对不同使用场景及操作系统平台,分别演示具体的配置方法。

临时使用国内PyPI镜像安装

方式一:临时使用国内PyPI镜像进行安装


pip install -i http://pypi.douban.com/simple/ numpy
pip install -i http://pypi.douban.com/simple/--trusted-host pypi.douban.com #此参数“--trusted-host”表示信任,如果上一个提示不受信任,就使用这个

永久使用国内PyPI镜像安装

方式二:永久使用国内PyPI镜像进行安装

Linux平台配置方法

1、Linux平台配置方法:

(1)创建pip.conf配置文件

首先执行以下命令:


cd ~/.pip  # 运行此命令切换目录

若提示目录不存在,请手动创建该目录(若已存在则跳过此步),操作如下:


mkdir ~/.pip
cd ~/.pip

在 .pip 目录下新建一个名为 pip.conf 的文件,具体操作如下:


touch pip.conf

(2)编辑 pip.conf 文件内容

首先打开该文件,命令如下:


sudo vi ~/.pip/pip.conf

接着,在文件中写入以下内容:


[global] 
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = https://pypi.tuna.tsinghua.edu.cn # trusted-host 此参数是为了避免麻烦,否则使用的时候可能会提示不受信任

保存并退出文件即可生效。

Windows平台配置方法

2、Windows平台配置方法:

(1)新建pip配置文件夹,直接在用户目录(即%HOMEPATH%\pip)下创建一个名为 pip 的文件夹,如下图所示:

(2)接着在 pip 文件夹中创建一个名为 pip 的文本文件,并将后缀名从 ".txt" 修改为 ".ini",格式如下所示:

文件内容填写如下:


[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = https://pypi.tuna.tsinghua.edu.cn # trusted-host 此参数是为了避免麻烦,否则使用的时候可能会提示不受信任

保存修改后,启动CMD命令行窗口,执行 "pip install xxx"(xxx为待安装的包名),即可默认使用国内源进行下载。

以上内容即为Python pip配置国内源的全部教程,希望对各位的学习有所帮助,也欢迎大家继续支持本站。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。