pip install 指定清华源需分临时与永久:临时用pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ 包名;永久推荐为当前venv单独配置$VIRTUAL_ENV/pip/pip.conf(Linux/macOS)或pip.ini(Windows),避免影响其他环境。

pip install 时如何指定清华源
在 venv 中 pip 默认走官方源,国内直连极慢甚至超时。最直接的办法是临时用 -i 参数覆盖源地址:
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/- 注意末尾的
/simple/不能省,否则返回 404 或重定向失败 - 该方式只对单次命令生效,不改变 venv 内 pip 的默认行为
为当前 venv 配置全局镜像(推荐)
避免每次敲长参数,可给当前虚拟环境单独配 pip.conf(Linux/macOS)或 pip.ini(Windows),且只影响该 venv,不影响系统或其他环境:
- 先激活 venv:
source venv/bin/activate(macOS/Linux)或venv\Scripts\activate(Windows) - 创建配置目录:
mkdir -p $VIRTUAL_ENV/pip(Linux/macOS),Windows 对应mkdir %VIRTUAL_ENV%\pip - 写入配置文件:
echo "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple/" > $VIRTUAL_ENV/pip/pip.conf(Linux/macOS);Windows 用echo [global] > %VIRTUAL_ENV%\pip\pip.ini && echo index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ >> %VIRTUAL_ENV%\pip\pip.ini - 验证是否生效:
pip config list应输出global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple/'
为什么不用 ~/.pip/pip.conf?
用户级配置(~/.pip/pip.conf 或 %APPDATA%\pip\Pip\pip.ini)会影响所有 Python 环境,包括系统 Python 和其他 venv,容易引发意外行为:
- 新建 venv 后误装了旧版包(因缓存或镜像同步延迟)
- 团队协作时,别人拉你代码跑 venv,却因本地全局配置导致依赖安装结果不一致
- 某些 CI 环境禁止修改用户级配置,硬写会失败
- venv 自带
$VIRTUAL_ENV/pip/目录优先级高于用户级,天然隔离
清华源偶尔 503 或返回空列表怎么办
清华源本身稳定,但偶发维护或网络抖动会导致 pip 报 HTTPError: 503 Server Error 或 No matching distribution,这不是配置问题:
立即学习“Python免费学习笔记(深入)”;
- 先试
curl -I https://pypi.tuna.tsinghua.edu.cn/simple/requests/看是否能通;不通就等几分钟再试 - 不要盲目换阿里云、豆瓣源——不同镜像同步策略不同,可能缺新包(如刚发布的
torch预编译轮子) - 临时回退到官方源调试:
pip install -i https://pypi.org/simple/ requests - 若频繁出问题,检查是否开了代理或公司防火墙拦截了
.tuna.tsinghua.edu.cn



















