Python配置pip国内镜像源的实现

Dylan
Dylan
发布时间:2026-10-14| 4人浏览过
原创

本文详细介绍如何在Windows和Linux系统中配置Python pip国内镜像源,以解决Sublime Text3中导入numpy等包时的报错问题。通过创建pip.ini或pip.conf文件,指定清华大学、阿里云或豆瓣镜像地址,可显著提升下载速度并避免超时失败。文章包含具体配置步骤、代码示例及升级pip的操作指南,帮助用户快速完成环境搭建。

Python配置pip国内镜像源教程

在使用Sublime Text3进行Python开发时,若尝试导入numpy模块却提示找不到包,通常是因为pip未配置合适的下载源。为了能够顺利执行from numpy import *语句并正常使用numpy库,必须正确配置pip的镜像源。接下来将介绍如何配置国内镜像源以解决该问题。

配置pip镜像源与配置Maven镜像源原理相似,核心目的是使用国内服务器以获取更快的下载速度。若默认使用国外源,下载过程往往极其缓慢,甚至因网络超时导致下载失败。许多开发者在经历国外源的慢速体验后,转向国内源会发现效率有显著提升。因此,在安装pip之前或之后配置镜像源是必要的步骤,下面介绍几种可以永久生效的配置方法。

Windows系统下配置pip镜像源

在Windows系统下配置pip镜像源

首先需要新建一个文件来指定镜像源的下载网址,具体操作如图所示:


如上图所示,需要在C盘当前用户目录下新建一个名为pip的文件夹。在该文件夹内创建一个后缀为“.ini”的文件,建议文件名为pip.ini。文件格式应参照图示示例,此时文件图标变为齿轮形状即表示配置正确。

推荐几个国内可用的镜像站,经个人使用验证,清华大学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

随后在pip.ini文件中添加以下配置内容,即可实现快速下载:


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

本人使用的是清华大学镜像源,用户也可尝试其他镜像源,均能正常工作。

配置阿里的pip镜像源


[global]
index-url = http://mirrors.aliyun.com/pypi/simple
[install]
trusted-host = http://mirrors.aliyun.com/pypi

配置豆瓣的pip镜像源


[global]
index-url = http://pypi.douban.com/simple
[install]
trusted-host = http://pypi.douban.com

保存好配置文件后,打开cmd命令行窗口准备开始下载pip。


pip install numpy

如图所示,下载已成功完成:


此时会出现黄色字体的提示信息,要求对pip进行升级。请按照提示中的命令执行升级操作。


python -m pip install --upgrade pip

升级完成后,pip便正式安装就绪,如下图所示:


下载并升级完成后,关闭Sublime Text3并重新启动。再次导入包并使用numpy时,即可正常运行而不再报错。

Linux系统下配置pip镜像源

在Linux系统下配置pip镜像源

Linux下的配置方式与Windows类似,需要在系统目录下创建pip.conf文件: 首先创建一个.pip目录:


mkdir ~/.pip
cd ~/.pip

然后在.pip目录下创建pip.conf文件:


vi pip.conf

最后在该文件中配置与Windows下pip.ini相同的内容,此处仍以清华大学镜像源为例:


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

按Esc键退出编辑模式,输入:wq保存并退出文件。此时即可在Linux系统下使用pip下载命令,操作方式与Windows下的cmd一致。 完成上述配置后,下载库并再次使用numpy即可避免报错。

到此关于Python配置pip国内镜像源的实现介绍完毕,更多相关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 算法库。