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

你可能感兴趣的:(python相关,pip)