【Python】国内可用的高速pip镜像源大全

发布于:2025-08-31 ⋅ 阅读:(31) ⋅ 点赞:(0)

1 为什么需要镜像源

pip 镜像源的作用是加速 Python 包的下载速度,并提高安装成功率pip 默认从 https://pypi.org/simple 下载包,但该服务器位于国外,在国内访问时可能会遇到:

  • 下载速度慢

  • 连接超时

  • 安装失败(如 ReadTimeoutError

下面列出一些常见好用的国内镜像源

2 如何使用镜像源

临时使用(单次)
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
永久配置(推荐)
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

01 阿里云镜像源:含有的镜像源库更加丰富

https://mirrors.aliyun.com/pypi/simple/

临时使用:

pip install -i https://mirrors.aliyun.com/pypi/simple/ package_name

永久配置:

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

02 清华大学镜像源

https://pypi.tuna.tsinghua.edu.cn/simple

临时使用:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name

永久配置:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

03中国科技大学镜像源

https://pypi.mirrors.ustc.edu.cn/simple/

临时使用:

pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ package_name

永久配置:

pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple/

04豆瓣镜像源

https://pypi.doubanio.com/simple/

临时使用:

pip install -i https://pypi.doubanio.com/simple/ package_name

永久配置:

pip config set global.index-url https://pypi.doubanio.com/simple/

05 华为云镜像源

https://mirrors.huaweicloud.com/repository/pypi/simple/

临时使用:

pip install -i https://mirrors.huaweicloud.com/repository/pypi/simple/ package_name

永久配置:

pip config set global.index-url https://mirrors.huaweicloud.com/repository/pypi/simple/

06 腾讯云镜像源

https://mirrors.cloud.tencent.com/pypi/simple

临时使用:

pip install -i https://mirrors.cloud.tencent.com/pypi/simple package_name

永久配置:

pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple

pip添加可信镜像源

pip config set global.trusted-host mirrors.aliyun.com

Pip镜像源配置指南

正确配置pip镜像源可以大幅提升Python包的安装速度,解决因网络问题导致的安装失败。以下是详细的配置指南:

临时使用镜像源

在安装包时通过-i参数指定镜像源:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name

永久配置镜像源

使用pip config命令设置全局镜像源:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

或者手动编辑pip配置文件:

# Linux/MacOS: ~/.pip/pip.conf # Windows: %USERPROFILE%\pip\pip.ini [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn

配置多个镜像源

在pip配置文件中可以设置多个镜像源:

[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple extra-index-url = https://mirrors.aliyun.com/pypi/simple/ https://pypi.doubanio.com/simple/

验证配置是否生效

使用以下命令查看当前配置:

pip config list

Pip镜像源常见问题解答

如何测试镜像源的下载速度?

可以使用以下命令测试下载速度:

time pip install -i https://mirror-url/simple numpy

记录安装时间,然后更换镜像源后再次测试,比较安装时间差异。

为什么有些包安装时仍然使用官方源?

可能的原因包括:1) 镜像源没有同步该包的最新版本;2) 包在镜像源中被标记为不可用;3) 配置了多个镜像源,pip按顺序尝试。可以尝试指定镜像源临时安装,或联系镜像源维护者。

如何恢复使用官方源?

使用以下命令恢复默认配置:

pip config unset global.index-url

或者删除pip配置文件。

企业应该选择哪种镜像源?

对于企业用户,建议:1) 使用私有镜像源;2) 选择提供企业级服务的镜像源;3) 配置镜像同步策略;4) 实施安全扫描;5) 建立完善的镜像管理流程。

源:国内高速pip镜像源大全 | 永久免费Python安装加速地址及配置指南

参考整理


网站公告

今日签到

点亮在社区的每一天
去签到