pip默认走国外源https://pypi.org/simple/导致慢,因物理距离远、无CDN、出口带宽受限;推荐临时用清华、中科大或阿里云镜像源,命令为pip install 包名 -i 镜像地址/simple/。

pip install 为什么默认走国外源,慢到卡住
因为 pip 默认源是 https://pypi.org/simple/,物理距离远、出口带宽受限,加上没有 CDN 加速,国内直连经常超时或限速。不是你网络差,是它本来就没为国内用户优化。
常见错误现象:ReadTimeoutError、ConnectionError、下载卡在 “Downloading …” 十几分钟不动、反复重试后失败。
使用场景:临时装一个包(比如 requests)、CI/CD 构建中不想改配置、虚拟环境中快速验证依赖。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 加
-i参数指定镜像源,仅本次命令生效,不影响全局设置 - 优先用清华、中科大、阿里云源——稳定、同步及时、支持 HTTPS
- 记得加
--trusted-host(仅当源用 HTTP 时需要;现在主流镜像都用 HTTPS,可省略)
临时换源的正确 pip install 命令写法
不用改配置文件,一条命令搞定。关键点是参数顺序和协议一致性:
✅ 正确(清华源,HTTPS,推荐):pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/
✅ 正确(阿里云源):pip install requests -i https://mirrors.aliyun.com/pypi/simple/
❌ 错误:漏掉末尾 /simple/ → 返回 404 或跳转失败
❌ 错误:写成 http://(非 https://)且没加 --trusted-host → SSL 验证失败
❌ 错误:把 -i 放在包名后面 → pip 解析失败,报错 unrecognized arguments
哪些镜像源能用?延迟和同步频率差异大
不是所有“国内镜像”都靠谱。有些小众源同步不及时(缺新包)、响应慢、甚至已下线。实测可用且稳定的有:
- 清华源:
https://pypi.tuna.tsinghua.edu.cn/simple/— 同步频率约 5 分钟,全国 CDN 覆盖好 - 中科大源:
https://pypi.mirrors.ustc.edu.cn/simple/— 稳定,但偶尔同步延迟 10–20 分钟 - 阿里云源:
https://mirrors.aliyun.com/pypi/simple/— 延迟略高(约 15 分钟),但抗压强,适合批量安装
别用百度源或某些博客里抄来的过期地址——很多已停更,返回空列表或 502。
装包中途断了,再运行会重复下载吗
不会。pip 默认启用缓存机制,下载的 wheel 文件会存到本地缓存目录(如 ~/.cache/pip)。只要没手动清空,重试时会直接复用。
但要注意两个例外:
- 如果用了
--no-cache-dir,每次都是全新下载 - 如果包版本没锁死(比如只写
numpy没写numpy==1.24.3),下次可能拉新版本,又得重新下
所以临时加速时,不加 --no-cache-dir 是默认行为,放心重试。
真正容易被忽略的是:有些公司内网禁用了外部 HTTPS 的 443 端口,或者代理策略拦截了镜像域名——这时换源也没用,得先确认网络策略是否放行 pypi.tuna.tsinghua.edu.cn 这类域名。










