解决 uv 下载速度慢的问题,最直接有效的办法是配置镜像源。通过设置环境变量 uv_index_url 指向国内高速镜像(如清华源),可以显著降低延迟并提升下载速度。

如何配置清华镜像源加速?
使用环境变量 UV_INDEX_URL 指定索引地址即可生效。该变量会覆盖默认行为,让 uv 从指定的 URL 获取包信息。

export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple uv pip install requests
为什么有时配置了镜像仍然很慢?
如果配置了镜像但速度未改善,通常是因为网络环境存在 DNS 污染或中间节点干扰。此时可以尝试切换至其他备用镜像,例如阿里云或华为云源,以排除特定镜像节点的拥堵问题。

export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ uv pip install numpy
基于 uv pip install 命令的具体执行流程是怎样的?
当执行 uv pip install 时,程序首先解析依赖树,然后向配置的镜像源发起 HTTP 请求下载 .whl 文件。若网络通畅,下载过程将直接写入缓存目录;若失败,则抛出连接异常。此过程完全依赖于底层 HTTP 客户端的网络状态及镜像源的响应速度。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











