一键配置国内镜像源，让pip下载速度飞起来

作者：唐叔在学习
专栏：唐叔学python
关键词：pip安装慢、Python镜像源、pip提速、PyPI国内源、Python配置

问题根源：为什么pip这么慢？

默认PyPI服务器在国外，国内直接访问速度极慢，经常出现Timeout错误。

解决方案：切换国内镜像源

方法一：临时使用（适合偶尔安装）

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

温馨提示：-i 是 --index-url 的简写形式，两指令是等价的。

常用镜像源：

• 清华：https://pypi.tuna.tsinghua.edu.cn/simple/
• 阿里云：https://mirrors.aliyun.com/pypi/simple/
• 华为云：https://repo.huaweicloud.com/repository/pypi/simple/

方法二：永久配置（推荐所有用户）

一键设置命令：

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

手动配置（如命令无效）：
创建配置文件：

• Windows：C:\Users\用户名\pip\pip.ini
• Linux/Mac：~/.pip/pip.conf

内容：

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

验证配置：

pip config list

备选方案：其他加速方法

如果镜像源仍不理想：

• 使用-v参数：pip install -v 包名
• 检查网络环境，尝试切换网络

总结

方法	优点	缺点	适用场景
临时指定镜像 (-i)	灵活，不影响全局配置	每次安装都需要输入长命令	偶尔使用，或测试不同镜像速度
设置为默认镜像	一劳永逸，使用最方便	需要修改配置文件	强烈推荐，适合所有用户
使用加速工具	可能突破某些网络限制	需要安装额外软件，配置稍复杂	镜像源速度依然不理想时的备选方案

最佳实践：直接执行永久配置命令，选择清华或阿里云镜像源。

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

这一行命令即可解决99%的pip安装慢问题，安装速度提升明显。

---

扩展知识

--extra-index-url ：不替换默认源，而是 添加一个额外的索引源。

• 当使用 --index-url 或者 -i 时，pip 只会从你指定的源查找包。
• 当使用 --extra-index-url 时，pip 会同时从默认源（或你通过 --index-url 指定的主源）和你提供的额外源查找包。如果一个包在多个源都存在，pip 会按照优先级顺序选择。

示例：
如果你想主要使用清华镜像，但如果某个包在清华镜像上没有，还允许它从官方 PyPI 查找，可以这样写：

pip install --index-url https://pypi.tuna.tsinghua.edu.cn/simple --extra-index-url https://pypi.org/simple requests

下次安装不再等待！有问题欢迎评论区留言讨论~