作为一名 Python 开发者,你一定遇到过这样的场景:深夜加班时,一个简单的 pip install 命令却卡在"Downloading…"界面,进度条慢如蜗牛。这不是你的网络问题,而是默认的 PyPI 服务器位于海外,网络延迟导致的。本文将介绍如何配置国内镜像源,让 pip 下载速度显著提升。
一、为什么需要换源?
pip 作为 Python 的包管理工具,默认从官方 PyPI 源(https://pypi.org)下载包。但由于服务器位于国外,国内用户访问时经常遇到:
- 下载速度极慢:几 MB 的包可能需要几分钟甚至超时
- 连接不稳定:频繁出现"Read timed out"错误
- 安装失败:网络波动导致下载中断
通过更换为国内镜像源,你可以:
- 🚀 下载速度提升 5-10 倍
- 🛡 连接更稳定,减少失败率
- 🔄 支持多源备份,自动选择最快线路
二、临时换源(单次生效)
如果你只是临时需要安装某个包,可以使用 -i 参数指定镜像源:
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
示例:使用清华源安装 numpy
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
适用场景:
- 临时安装测试某个包
- 不需要修改全局配置
- 在他人电脑上操作时
三、永久换源(全局生效)
如果你希望所有 pip 操作都默认使用国内源,推荐永久配置:
方法一:命令行配置(最简单)
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
方法二:手动修改配置文件
Windows 系统:
- 创建或编辑文件:
C:\Users\用户名\pip\pip.ini - 添加以下内容:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
Linux/macOS 系统:
- 创建或编辑文件:
~/.pip/pip.conf - 添加相同内容
验证配置是否生效:
pip config list
输出应包含:global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'

