Back

如何设置pip镜像源加速Python包安装

TLDR

临时使用镜像
例如，临时使用本镜像站来升级 pip：
设为全局默认镜像源

为什么要设置pip镜像源？

默认的pip源服务器位于国外，国内用户下载Python包时可能会遇到：
  • 下载速度慢
  • 连接不稳定
  • 频繁超时
通过修改为国内镜像源，可以显著提高包下载速度和稳定性。

国内常用pip镜像源

推荐使用以下国内镜像源：
  1. 清华大学：
    (文档：pypi | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror)
  2. 阿里云：
  3. 豆瓣：
  4. 华为云：

临时使用镜像源

在pip安装命令后添加
参数：

永久设置镜像源

方法一：修改pip配置文件

  1. 创建或编辑pip配置文件：
  2. 添加以下内容（以清华大学源为例）：

方法二：使用命令行设置

验证镜像源是否生效

  1. 查看当前配置：
  2. 测试下载速度：

注意事项

  1. 使用HTTPS源更安全
  2. 某些企业网络可能需要配置代理
  3. 如果遇到SSL错误，可以添加
    参数：

常见问题

Q: 如何恢复默认源？ A: 删除pip配置文件或执行：
Q: 为什么设置了镜像源还是下载慢？ A: 可能是：
  1. 镜像源本身有问题，尝试换其他源
  2. 网络连接问题，检查网络设置
Q: 如何为特定项目设置不同的源？ A: 在项目目录下创建
文件，内容格式与全局配置相同
Q: Windows系统如何设置？ A: 配置文件路径为：
，其他操作与Linux相同