在 Python 中,使用 pip 安装包时,默认的软件源(PyPI,Python Package Index)位于国外,国内用户可能会遇到下载速度慢或连接不稳定的问题。为了提高下载效率,可以切换至国内镜像源(镜像站),以下是常用的 pip 源及其配置方法:
常用国内镜像源
镜像源名称镜像源地址特点清华大学源https://pypi.tuna.tsinghua.edu.cn/simple更新频率高,稳定性好阿里云源https://mirrors.aliyun.com/pypi/simple速度快,支持 HTTPS腾讯云源https://mirrors.cloud.tencent.com/pypi/simple腾讯云用户推荐华为云源https://repo.huaweicloud.com/repository/pypi/simple企业级稳定服务豆瓣源https://pypi.doubanio.com/simple历史久,但偶尔更新延迟中科大源https://pypi.mirrors.ustc.edu.cn/simple教育网用户推荐
国外常用源
镜像源名称镜像源地址特点官方 PyPIhttps://pypi.org/simple默认源,但国内访问慢备用官方源https://pypi.python.org/simple旧版地址,逐渐弃用
如何配置 pip 源
1. 临时使用镜像源
在 pip install 命令后直接指定源地址
pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
2. 永久配置镜像源
修改 pip 的全局配置文件,避免每次手动指定源。
Linux/macOS
创建或编辑配置文件:
mkdir -p ~/.pip
vim ~/.pip/pip.conf
写入以下内容(以清华源为例):
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn # 如果镜像源未启用 HTTPS 需添加
Windows
在用户目录(如 C:\Users\YourUsername\)下创建 pip 文件夹。
在 pip 文件夹中新建文件 pip.ini,内容同上:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
验证配置是否生效
执行以下命令查看当前使用的源:
pip config list