文章目录
- 在pip install命令后追加 -i 参数,指定国内源地址: # 安装单个包(以安装numpy为例) pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple # 安装多个包(以安装torch+torchvision为例) pip install torch torchvision torchaudio -i https://pypi.tuna.tsinghua.edu.cn/simple # 升级pip本身也能用 pip install –upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
- 镜像源名称 地址 稳定性 适用场景 清华源 https://pypi.tuna.tsinghua.edu.cn/simple ★★★★★(最优) 日常开发、大体积包(如 torch) 阿里源 https://mirrors.aliyun.com/pypi/simple/ ★★★★☆ 南方地区用户、网络波动时备选 豆瓣源 https://pypi.douban.com/simple/ ★★★☆☆ 轻量包、应急使用(偶尔同步延迟) 中科大源 https://pypi.mirrors.ustc.edu.cn/simple/ ★★★★☆ 北方地区用户 实测:安装 torch(约 2GB)时,清华源平均耗时 2 分钟,官方源耗时 15 + 分钟(甚至超时失败)。
-
- 打开文件资源管理器,输入路径 %APPDATA% 并回车(快速进入用户配置目录); 在该目录下新建文件夹,命名为 pip; 进入pip文件夹,新建文本文档,重命名为 pip.ini(注意后缀是.ini,不是.txt)。
- 用记事本打开pip.ini,粘贴以下内容(推荐清华源): [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn index-url:指定默认镜像源; trusted-host:信任该源的 HTTPS 证书(避免证书验证报错)。
- 执行以下命令,若输出的index-url是清华源,则配置成功: pip config list
目录
- 一、方案 1:临时使用国内源(最快上手)
- 用法
- 主流国内源汇总(附稳定性对比)
- 二、方案 2:永久配置国内源(一劳永逸)
- 1. Windows 系统
- 步骤 1:创建 pip 配置文件
- 步骤 2:编辑 pip.ini 内容
- 2. macOS/Linux 系统
- 步骤 1:创建 pip 配置文件
- 步骤 2:编辑 pip.conf 内容
- 验证是否生效
- 三、方案 3:用 pip 镜像加速器(自动选最优源)
- 推荐工具:pip-fast
- 安装方法
- 使用方法
- 四、避坑小贴士
- 总结
日常用 Python 开发时,pip install 安装第三方包的速度很慢—— 有时候几秒搞定,有时候卡半小时还失败。尤其是安装 torch、tensorflow 这类大体积包时,慢到让人怀疑人生。

其实pip install慢的核心原因就 3 个:
1.默认镜像在国外:PyPI 官方源服务器位于国外,跨国网络传输延迟高、带宽受限;
2.网络波动:家用网络 / 办公网络的跨境链路不稳定,容易出现超时、断连;
3.包依赖复杂:部分包(如科学计算类)依赖层级多,每个子依赖都要单独下载,耗时翻倍。
本文整理了 6 种从「临时应急」到「长期根治」的提速方案,附实测耗时对比,新手也能一键上手!
这是最常用的「临时解决方案」,无需修改任何配置,安装包时直接指定国内镜像源即可。
在pip install命令后追加 -i 参数,指定国内源地址:
# 安装单个包(以安装numpy为例) pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple # 安装多个包(以安装torch+torchvision为例) pip install torch torchvision torchaudio -i https://pypi.tuna.tsinghua.edu.cn/simple # 升级pip本身也能用 pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
| 镜像源名称 | 地址 | 稳定性 | 适用场景 |
|---|---|---|---|
| 清华源 | https://pypi.tuna.tsinghua.edu.cn/simple | ★★★★★(最优) | 日常开发、大体积包(如 torch) |
| 阿里源 | https://mirrors.aliyun.com/pypi/simple/ | ★★★★☆ | 南方地区用户、网络波动时备选 |
| 豆瓣源 | https://pypi.douban.com/simple/ | ★★★☆☆ | 轻量包、应急使用(偶尔同步延迟) |
| 中科大源 | https://pypi.mirrors.ustc.edu.cn/simple/ | ★★★★☆ | 北方地区用户 |
实测:安装 torch(约 2GB)时,清华源平均耗时 2 分钟,官方源耗时 15 + 分钟(甚至超时失败)。
临时源每次都要手动加参数,长期开发建议「永久配置」,后续所有pip install都会自动走国内源。
- 打开文件资源管理器,输入路径
%APPDATA% 并回车(快速进入用户配置目录);
- 在该目录下新建文件夹,命名为
pip;
- 进入
pip文件夹,新建文本文档,重命名为 pip.ini(注意后缀是.ini,不是.txt)。
%APPDATA% 并回车(快速进入用户配置目录);pip;pip文件夹,新建文本文档,重命名为 pip.ini(注意后缀是.ini,不是.txt)。
用记事本打开pip.ini,粘贴以下内容(推荐清华源):
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn
index-url:指定默认镜像源;trusted-host:信任该源的 HTTPS 证书(避免证书验证报错)。
打开终端,执行以下命令(创建.pip目录和pip.conf文件):
# 进入用户根目录 cd ~ # 创建.pip目录(若已存在则跳过) mkdir -p .pip # 编辑pip.conf文件 vim ~/.pip/pip.conf
在 vim 编辑器中输入以下内容(按i进入编辑模式,编辑完成后按Esc+:wq保存退出):
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn
执行以下命令,若输出的index-url是清华源,则配置成功:
pip config list
如果觉得手动切换源麻烦,可以用第三方工具「自动选择当前最快的国内源」,比如pip国内源合集工具或pip-mirror。
这是一款轻量工具,会自动测试多个国内源的速度,选择最快的进行安装。
pip install pip-fast -i https://pypi.tuna.tsinghua.edu.cn/simple
将原来的pip install替换为pip-fast install即可:
# 安装numpy,自动选最快源 pip-fast install numpy # 安装torch,支持大体积包 pip-fast install torch torchvision torchaudio
1.若配置国内源后仍慢:先清空 pip 缓存(pip cache purge),缓存中的失效文件会拖慢下载;
2.Windows 用户注意:修改pip.ini时,确保文件后缀是.ini(不是.txt),否则配置不生效;
3.代理加速失败:检查代理端口是否正确,关闭系统防火墙后重试;
4.优先选清华源:对比阿里 / 豆瓣源,清华源的同步速度最快、稳定性最高。
1.临时使用:直接加 -i 清华源,最快上手;
2.长期开发:永久配置清华源,一劳永逸;
3.内网 / 断网:离线下载 whl 包本地安装;
4.科学计算包:优先用 conda 安装,减少依赖问题;
5.追求极致速度:配置代理加速,速度拉满。
到此这篇关于pip install 下载太慢的6种提速方法的文章就介绍到这了,更多相关pip install 下载太慢内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客!
您可能感兴趣的文章:
- Python踩坑全记录之pip install下载慢的终极解决指南
- pip install速度太慢的解决方法汇总
- Python解决pip install numpy过慢问题的几种方法
- Python切换pip源两种方法(解决pip install慢)
- 一劳永逸彻底解决pip install慢的办法
- Python 安装第三方库 pip install 安装慢安装不上的解决办法