为什么你需要这篇pip换源教程?
每次用pip install等待十几分钟,结果却显示Connection timeout时,那种烦躁感Python开发者都懂。默认的PyPI服务器位于国外,国内用户常遇到下载速度慢、安装失败等问题。电脑pip换源就是将下载源切换至国内镜像站,速度能提升5-10倍。下面我们将用最直白的方式,教你三种主流换源方法。
一、临时单次换源方法
适合偶尔需要快速安装特定包的情况:
- 命令格式:
pip install -i 镜像URL 包名 - 推荐镜像:
- 清华:https://pypi.tuna.tsinghua.edu.cn/simple
- 阿里云:https://mirrors.aliyun.com/pypi/simple

- 示例:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy
Q:临时换源有什么缺点?
需要每次手动添加-i参数,不适合频繁使用pip的场景。如果忘记加参数,又会回退到龟速的默认源。
二、永久换源配置方案
通过修改pip配置文件实现一劳永逸:
2.1 Windows系统操作步骤
- 在文件资源管理器地址栏输入:
%APPDATA%回车 - 新建
pip文件夹(如果不存在) - 在文件夹内创建
pip.ini文件,内容为:[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple
2.2 Mac/Linux系统操作步骤
- 打开终端执行:
mkdir -p ~/.pip - 创建配置文件:
nano ~/.pip/pip.conf - 写入相同内容后按Ctrl+X保存
三、验证换源是否成功
执行以下命令检查配置效果:
pip config list- 查看当前生效的配置pip install -v numpy- 观察下载地址是否变更为镜像站
常见问题排查表
| 问题现象 | 解决方案 |
|---|---|
| 仍然从pypi.org下载 | 检查配置文件路径和格式是否正确 |
| 出现SSL证书错误 | 在配置文件中添加trusted-host = 镜像域名 |
四、高级用户的多源配置
针对不同场景可以使用多源切换:
- 备用源设置:在配置文件中添加
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple extra-index-url = https://mirrors.aliyun.com/pypi/simple
- 企业内网源:可搭配
--proxy参数使用
有些开发者习惯用conda管理环境,其实conda也可以换源:conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/。不过这就是另一个话题了。