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安装加速地址及配置指南
参考整理