LI SIR - 个人博客

深浅模式

pip 使用国内镜像源 ​

更新: 3/9/2025 字数: 0 字 时长: 0 分钟

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

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

临时使用镜像源 ​

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

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

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

全局配置镜像源 ​

  • pip 命令配置方法

    说明

    • 升级 pip 到最新的版本
    bash
    python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --upgrade pip
    • 将配置写入到用户对应的配置文件中
    bash
    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 文件中输入以下内容
    ini
    [global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

  • Linux/Mac OS 手动配置方法

    说明

    • 创建 ~/.pip 目录（如果不存在）
    bash
    mkdir ~/.pip
    • 打开或创建配置文件 ~/.pip/pip.conf，并输入以下内容
    ini
    [global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = https://pypi.tuna.tsinghua.edu.cn

查看镜像地址 ​

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

    bash
    pip config list

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

  • 带上一个 -v 选项

    bash
    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 命令配置方法默认创建的是后者。

其他国内镜像源 ​

常用 pip 命令 ​

bash
# 升级 pip
pip install --upgrade pip
# 或
python -m pip install --upgrade pip
bash
# 查看已安装的包
pip list

# 安装包
pip install [包名]

# 安装本地包
pip install [目录]/[文件名]

# 查看包的安装位置
pip show [包名]

# 卸载包
pip uninstall [包名]
bash
# 查看可升级的包
pip list -o

# 升级包
pip install -U [包名]

# 搜索包
pip search [搜索关键字]
bash
# 导出依赖 
pip freeze > requirements.txt
# 或指定路径
pip freeze >  D:/requirements.txt

# 安装依赖
pip install -r requirements.txt
# 或指定路径
pip install -r D:/requirements.txt

贡献者

The avatar of contributor named as wkwbk wkwbk

页面历史