使用 pip 换源的指南

使用 pip 换源的指南

Python 包管理工具 pip 通常从官方的 PyPI（Python Package Index）仓库下载包。但由于网络限制或速度问题，我们可以选择使用国内镜像源来加速包的下载。以下是如何通过不同方法更改 pip 的下载源：

一、通过命令行临时换源

在安装 Python 包时，可以临时指定下载源。这样只对当前的命令有效，不会改变 pip 的全局配置。

使用示例

pip install 包名 -i 镜像URL

示例代码

例如，从清华大学的镜像源下载 numpy：

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

二、全局配置换源

我们可以通过修改配置文件的方式永久性地更改 pip 的下载源。

2.1 在 Windows 上

1. 打开命令提示符。

2. 找到或创建 pip 配置文件：

   • 路径：C:\Users\<用户名>\pip\pip.ini
   • 如果 pip 文件夹不存在，请创建它，然后在其中创建一个名为 pip.ini 的文件。

3. 编辑配置文件，添加以下内容：

   [global]
   index-url = 镜像URL
   

   示例：

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

2.2 在 macOS 或 Linux 上

1. 打开终端。

2. 找到或创建 pip 配置文件：

   • 路径：~/.pip/pip.conf
   • 如果 .pip 文件夹不存在，请创建它，然后在其中创建一个名为 pip.conf 的文件。

3. 编辑配置文件，添加以下内容：

   [global]
   index-url = 镜像URL
   

   示例：

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

三、通过环境变量换源

我们也可以通过设置环境变量来指定 pip 的下载源。

3.1 在 Windows 上

1. 打开系统环境变量设置：

   • 右键点击“此电脑”或“我的电脑”，选择“属性”。
   • 点击“高级系统设置”。
   • 在“系统属性”窗口中，点击“环境变量”。

2. 添加新环境变量：

   • 在“用户变量”或“系统变量”部分，点击“新建”。
   • 名称为 PIP_INDEX_URL，值为 镜像URL。

   示例：

   • 名称：PIP_INDEX_URL
   • 值：https://pypi.tuna.tsinghua.edu.cn/simple

3.2 在 macOS 或 Linux 上

1. 打开终端。

2. 编辑 shell 配置文件，例如 .bashrc 或 .zshrc。

3. 添加环境变量：

   export PIP_INDEX_URL=镜像URL
   

   示例：

   export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
   

4. 应用更改：

   source ~/.bashrc  # 或者 source ~/.zshrc
   

四、在开发工具中配置 pip 换源

4.1 在 PyCharm 或 IntelliJ IDEA 中

1. 打开项目设置：

   • 在菜单栏中选择 File > Settings（Windows 和 Linux）或 PyCharm > Preferences（macOS）。

2. 导航到 Python Interpreter：

   • 在设置窗口中，导航到 Project: <你的项目名> > Python Interpreter。

3. 配置包管理器：

   • 在右侧，点击 + 按钮添加新包。
   • 在弹出的窗口中，点击右上角的齿轮图标，然后选择 Manage Repositories。
   • 在弹出的对话框中，点击 + 按钮添加新的仓库 URL，输入你想使用的镜像源地址。

4. 添加镜像源：

   • 在弹出的窗口中输入镜像源 URL，例如 https://pypi.tuna.tsinghua.edu.cn/simple。
   • 点击 OK 确认添加。

4.2 在 VS Code 中

1. 打开终端：

   • 在 VS Code 中，使用快捷键 `Ctrl+``（反引号）打开终端。

2. 使用 pip 命令：

   • 使用命令行临时指定下载源进行安装，或配置环境变量使其永久生效。

五、常用的国内镜像源

• 清华大学 TUNA 镜像源：

  https://pypi.tuna.tsinghua.edu.cn/simple
  

• 豆瓣镜像源：

  https://pypi.doubanio.com/simple
  

• 阿里云镜像源：

  https://mirrors.aliyun.com/pypi/simple/
  

• 腾讯云镜像源：

  https://mirrors.cloud.tencent.com/pypi/simple
  

总结

以上是 pip 换源的几种常用方法，涵盖了命令行临时换源、全局配置换源、通过环境变量换源以及在开发工具中配置换源的方法。根据实际需求和环境选择合适的方法来加速包的下载和安装。