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

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

本文介绍如何在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 相关产品和应用

全部下载

专题列表