Python pip 默认从官方 PyPI 源下载包。由于服务器位于国外,国内用户访问时常遇到下载速度慢、连接不稳定等问题。配置国内镜像源可显著提升下载效率。
一、为什么需要换源?
pip 作为 Python 的包管理工具,默认从官方 PyPI 源(https://pypi.org)下载包。但由于服务器位于国外,国内用户访问时经常遇到:
Python pip 默认使用海外 PyPI 源导致下载速度慢或不稳定。通过配置国内镜像源可显著提升下载效率。支持临时指定源参数或修改全局配置文件实现永久生效。常用国内源包括清华大学、阿里云、中国科技大学等。常见问题涵盖 SSL 证书错误、配置不生效及升级失败等,可通过添加 trusted-host 参数或修复 pip 版本解决。建议根据网络环境选择合适镜像源并定期更新 pip。
Python pip 默认从官方 PyPI 源下载包。由于服务器位于国外,国内用户访问时常遇到下载速度慢、连接不稳定等问题。配置国内镜像源可显著提升下载效率。
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