pip install 使用国内镜像的方法示例

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

本文介绍如何在Python开发中将pip安装源替换为国内镜像,以解决下载慢和安装出错问题。涵盖临时使用参数、Linux及Windows永久配置文件修改,以及PyCharm集成环境下的镜像配置方法,提供清华、中科大、阿里云等常用源地址。

为什么使用国内镜像

对于Python开发者而言,使用pip安装第三方软件包是日常操作。然而,连接国外官方源往往面临下载速度缓慢的问题,不仅耗时,还容易在后续安装阶段出现错误。因此,将pip的安装源切换至国内镜像服务器,能够显著提升下载效率并提高安装成功率。

常用国内镜像源列表

以下是常用的国内镜像源列表:

需要注意的是,新版Ubuntu系统强制要求使用https协议的源,配置时请确保协议头正确。

清华大学开源软件镜像站:https://pypi.tuna.tsinghua.edu.cn/simple

中国科学技术大学开源镜像站:https://pypi.mirrors.ustc.edu.cn/simple/

阿里云开源镜像站:http://mirrors.aliyun.com/pypi/simple/

华中科技大学开源镜像站:http://pypi.hustunique.com/

山东理工大学开源镜像站:http://pypi.sdutlinux.org/ 

豆瓣开源镜像站:http://pypi.douban.com/simple/

临时使用国内源

若仅需临时使用国内源进行单次安装,可通过命令行参数指定:

在使用pip命令时,添加-i参数并指定镜像地址,例如:https://pypi.tuna.tsinghua.edu.cn/simple。

具体操作如:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyspider,该命令指示pip从清华大学镜像站下载并安装pyspider库。

永久配置国内源

若希望永久生效,避免每次手动指定参数,可进行全局配置:

在Linux系统中,需修改用户目录下的~/.pip/pip.conf文件。若该文件不存在,请手动创建。注意文件夹名以“.”开头,代表隐藏文件夹。

配置文件内容应包含全局索引URL设置,示例如下:


[global]

index-url = https://pypi.tuna.tsinghua.edu.cn/simple

[install]

trusted-host=mirrors.aliyun.com

在Windows系统中,需在用户目录(如C:\Users\xx\)下创建pip文件夹,并在其中新建pip.ini文件。文件内容格式与Linux下的pip.conf一致。

PyCharm中配置国内源

对于使用PyCharm集成开发环境的用户,可通过界面配置国内源:

依次点击File(文件)-> Settings(设置)-> Project:XXX(项目名称)-> Project Interpreter(项目解释器)。

完成上述添加操作后,即可在PyCharm环境中通过国内镜像源快速下载依赖库。

以上即为pip install使用国内镜像的完整配置示例。如需了解更多相关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 算法库。