作为一名 Python 开发者,你一定遇到过这样的场景:深夜加班时,一个简单的 pip install 命令却卡在"Downloading…"界面,进度条慢如蜗牛。这不是你的网络问题,而是默认的 PyPI 服务器位于海外,网络延迟导致的。本文将介绍如何配置国内镜像源,让 pip 下载速度显著提升。
一、为什么需要换源?
pip 作为 Python 的包管理工具,默认从官方 PyPI 源(https://pypi.org)下载包。但由于服务器位于国外,国内用户访问时经常遇到:
本文介绍 Python pip 工具下载速度慢的原因及解决方案。通过配置国内镜像源(如清华、阿里云、中科大),可显著提升下载速度并减少连接错误。内容涵盖临时换源命令、永久全局配置方法(命令行及配置文件)、常用镜像源对比表、常见问题处理(SSL 证书、配置不生效等)以及高级用法(批量安装、依赖导出)。建议根据网络情况选择稳定源,定期更新 pip 版本以确保性能与安全。
作为一名 Python 开发者,你一定遇到过这样的场景:深夜加班时,一个简单的 pip install 命令却卡在"Downloading…"界面,进度条慢如蜗牛。这不是你的网络问题,而是默认的 PyPI 服务器位于海外,网络延迟导致的。本文将介绍如何配置国内镜像源,让 pip 下载速度显著提升。
pip 作为 Python 的包管理工具,默认从官方 PyPI 源(https://pypi.org)下载包。但由于服务器位于国外,国内用户访问时经常遇到:
通过更换为国内镜像源,你可以:
如果你只是临时需要安装某个包,可以使用 -i 参数指定镜像源:
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
示例:使用清华源安装 numpy
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
适用场景:
如果你希望所有 pip 操作都默认使用国内源,推荐永久配置:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Windows 系统:
C:\Users\用户名\pip\pip.ini[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
Linux/macOS 系统:
~/.pip/pip.conf验证配置是否生效:
pip config list
输出应包含:global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
| 镜像源 | URL | 响应速度 | 推荐指数 |
|---|---|---|---|
| 清华大学 | https://pypi.tuna.tsinghua.edu.cn/simple | 8ms | ⭐⭐⭐⭐⭐ |
| 阿里云 | https://mirrors.aliyun.com/pypi/simple/ | 10ms | ⭐⭐⭐⭐⭐ |
| 中国科技大学 | https://pypi.mirrors.ustc.edu.cn/simple/ | 12ms | ⭐⭐⭐⭐☆ |
| 豆瓣 | https://pypi.doubanio.com/simple/ | 15ms | ⭐⭐⭐⭐☆ |
| 腾讯云 | https://mirrors.cloud.tencent.com/pypi/simple | 18ms | ⭐⭐⭐⭐ |
建议:根据你的地理位置和网络运营商选择最适合的源。清华大学源和阿里云源覆盖全国多节点 CDN,稳定性最佳。
如果遇到 SSL 证书验证失败,在配置文件中添加 trusted-host 参数:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
如果 pip install --upgrade pip 报错,使用以下方法修复:
# 方法 1:使用系统自带工具修复
python -m ensurepip --upgrade
# 方法 2:通过国内镜像离线安装
# 访问 https://pypi.tuna.tsinghua.edu.cn/simple/pip/ 下载对应版本的 whl 文件
python -m pip install pip-xx.xx.xx-py3-none-any.whl
如果想恢复使用官方 PyPI 源:
# 方法 1:删除配置文件
rm ~/.pip/pip.conf # Linux/macOS
del C:\Users\用户名\pip\pip.ini # Windows
# 方法 2:修改配置为官方源
pip config set global.index-url https://pypi.org/simple
创建 requirements.txt 文件:
numpy pandas matplotlib requests
使用国内源批量安装:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
pip freeze > requirements.txt
pip install package_name.whl
通过配置国内镜像源,你可以:
推荐配置:永久使用清华大学源或阿里云源,这两个源覆盖全国多节点 CDN,响应速度快且稳定性高。
温馨提示:镜像源速度受地区、运营商影响,建议根据实际网络情况选择最适合的源。定期更新 pip 版本也能获得更好的性能和安全性哦!

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online