pip 使用国内镜像源

默认情况下，pip 使用的是国外的镜像，下载速度较慢。

本文介绍如何使用国内清华大学的源来加速下载。

临时使用镜像源

可以通过 -i 参数临时指定镜像源，例如：

pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

该命令使用清华镜像源安装 numpy 包。此方法仅对当前命令有效。

全局配置镜像源

• pip 命令配置方法

  说明

  • 升级 pip 到最新的版本

  python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --upgrade pip

  • 将配置写入到用户对应的配置文件中

  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
  pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

• Windows 手动配置方法

  说明

  • 在当前用户目录下的 pip 文件夹中创建 pip.ini 文件，例如：C:\Users\你的用户名\pip\pip.ini
  • 在 pip.ini 文件中输入以下内容

  [global]
  index-url = https://pypi.tuna.tsinghua.edu.cn/simple
  [install]
  trusted-host = pypi.tuna.tsinghua.edu.cn

• Linux/Mac OS 手动配置方法

  说明

  • 创建 ~/.pip 目录（如果不存在）

  mkdir ~/.pip

  • 打开或创建配置文件 ~/.pip/pip.conf，并输入以下内容

  [global]
  index-url = https://pypi.tuna.tsinghua.edu.cn/simple
  [install]
  trusted-host = https://pypi.tuna.tsinghua.edu.cn

查看镜像地址

• 使用以下命令查看当前配置的镜像地址

  pip config list
  
  # 如果配置成功，输出应如下
  global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
  install.trusted-host='https://pypi.tuna.tsinghua.edu.cn'

• 带上一个 -v 选项

  pip config list -v
  
  # 输出
  For variant 'global', will try loading 'C:\ProgramData\pip\pip.ini'
  For variant 'user', will try loading 'C:\Users\LISIR\pip\pip.ini'
  For variant 'user', will try loading 'C:\Users\LISIR\AppData\Roaming\pip\pip.ini'
  For variant 'site', will try loading 'C:\Programs\Python310\pip.ini'
  global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
  install.trusted-host='pypi.tuna.tsinghua.edu.cn'

• global、user、site 分别表示配置文件生效的范围

  • global：全局，一般不用
  • user：当前用户，推荐
  • site：只针对某一个 python 解释器

可以看到 user 有两个地方，其中配置任何一个都是可以的。

手动配置方法创建的文件地址是前面那个，但是 pip 命令配置方法默认创建的是后者。

其他国内镜像源

• 中国科学技术大学：https://pypi.mirrors.ustc.edu.cn/simple
• 豆瓣：http://pypi.douban.com/simple/
• 阿里云：http://mirrors.aliyun.com/pypi/simple/