# uv设置默认国内源 **URL:** \ **Category:** 🛠工具与编程\ **Tags:** uv\ **Created:** [2025 年10 月 31 日 10:30 UTC](https://forum.beginner.center/t/topic/2329 "2025-10-31T10:30:33Z")\ **Posts on this page:** 1\ **Page:** 1
作者： ![doggie](https://forum.beginner.center/user_avatar/forum.beginner.center/doggie/32/550_2.png) [@doggie](https://forum.beginner.center/u/doggie)\ 发布日期： [2025 年10 月 31 日 10:30 UTC](https://forum.beginner.center/t/topic/2329/1 "2025-10-31T10:30:33Z")
> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [zhuanlan.zhihu.com](https://zhuanlan.zhihu.com/p/1930714592423703026) 大家好，我是小明同学。 兄弟们，最近你的朋友圈是不是也被一个叫 `uv` 的新工具刷屏了？ 号称比 `pip` 和 `venv` 快 10 到 100 倍，用 Rust 写的，作者还是 `ruff` 的大神 Charlie Marsh。我勒个去，这背景、这速度，简直就是 Python 包管理界的 “闪电侠” 啊！⚡ 于是乎，你兴冲冲地装上了 `uv`，敲下 `uv pip install pandas`，准备体验一下飞一般的感觉。 结果…… 看着那慢悠悠滚动的下载进度条，你是不是跟我一样，脑子里冒出一个大大的问号： “说好的快呢？这速度跟我的小电驴有啥区别？难道我装了个假的 `uv`？” **打住！先别急着卸载！** 问题不在 `uv`，而在于你和 PyPI 服务器之间的 “距离”。 ## **速度的瓶颈在哪？** `uv` 的快，主要快在解析依赖、本地处理这些环节。但下载包这个事儿，它也得老老实实走网络。 默认情况下，`uv` 和 `pip` 一样，都是去官方的 PyPI 仓库（[pypi.org](http://pypi.org)）下载包。这个服务器远在国外，咱们从国内访问，就好比走一条蜿蜒曲折、还可能随时堵车的乡间小路。网速再快，也架不住物理距离和国际网络的 “抖动”。 这时候，`uv` 就像一辆性能炸裂的超级跑车，却被堵在了村口，一身的力气使不出来。 那咋办？很简单， **给它换条高速公路！** 这条高速公路，就是咱们国内的镜像源。 清华源、阿里源、豆瓣源…… 这些镜像站把 PyPI 官方仓库的包都同步到了国内服务器上。我们直接从这些服务器下载，那速度，嗖嗖的！ ## **废话不多说，上操作！** 给 `uv` 配置镜像地址，有三种常用姿势，总有一款适合你。 ### **姿势一：临时抱佛脚（命令行指定）** 如果你只是偶尔想用一下镜像，或者想快速测试一下效果，可以直接在命令行里加个参数。 ```auto uv pip install numpy --default-index https://pypi.tuna.tsinghua.edu.cn/simple ``` ![](https://discoursecdn.beginner.center/original/2X/e/efe4b84642e6b06b98ab0a9f1ceac95b3bbb87cc.png) `--default-index` 就是用来指定镜像地址的。这样，这次 `install` 命令就会从清华源下载。 **优点** ：简单直接，用完就走。 **缺点** ：太麻烦了！每次都要输一长串，记不住啊！ ### **姿势二：一劳永逸（配置环境变量）✅** 这才是咱们今天主推的 “王炸” 方法！通过设置一个环境变量，让 `uv` 以后每次都默认从镜像源下载。 这个神奇的环境变量就是：`UV_DEFAULT_INDEX` **对于 macOS / Linux 用户 (zsh/bash):** 1. 打开你的终端。 2. 执行下面的命令，把它添加到你的 shell 配置文件里（比如 `.zshrc` 或 `.bashrc`）。 ```auto # 推荐使用清华源 echo 'export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"'>> ~/.bashrc # 或者用阿里源 # echo 'export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"' >> ~/.bashrc # 让配置立即生效 source ~/.bashrc ``` ![](https://discoursecdn.beginner.center/original/2X/b/b2e232df10fb356aec9cd967b3370acd39d455e3.jpeg) 搞定！以后不管你在哪个项目里用 `uv`，都会自动走镜像了。 **对于 Windows 用户:** 1. 在 PowerShell 中执行（只在当前窗口有效）： ```auto $env:UV_DEFAULT_INDEX = "https://pypi.tuna.tsinghua.edu.cn/simple" ``` ![](https://discoursecdn.beginner.center/original/2X/6/61e5e92567739d29228f9314f7d9d9ec640dcc6c.jpeg) 1. 想永久生效？得添加到系统环境变量里。 - 右键 “此电脑” → “属性” → “高级系统设置” → “环境变量”。 - 在 “用户变量” 或“系统变量”里，点击“新建”。 - 变量名填 `UV_DEFAULT_INDEX`，变量值填 `https://pypi.tuna.tsinghua.edu.cn/simple`。 - 一路确定，然后 **重启你的终端** （比如 PowerShell 或 CMD）让它生效。 ![](https://discoursecdn.beginner.center/original/2X/0/00a34e112e6d9e1539f9fc1bcdcad4509efa7f40.jpeg) ### **姿势三：项目级定制（pyproject.toml）** 如果你的项目需要和团队成员保持镜像源统一，或者有特殊的包源需求，可以把配置写在项目根目录的 `pyproject.toml` 文件里。 ```auto [[tool.uv.index]] url="https://pypi.tuna.tsinghua.edu.cn/simple" default=true ``` ![](https://discoursecdn.beginner.center/original/2X/6/6bfd3b1865ffd96c128813783e426fd2b08301b4.jpeg) `uv` 会优先读取这个项目级的配置，非常适合团队协作。 ## **怎么知道我配成功了没？** 很简单，随便装个包，加上 `-v` (verbose) 参数，看看日志。 ```auto uv pip install-v requests ``` ![](https://discoursecdn.beginner.center/original/2X/8/8d147298d9cc5217c0a055b5f32f438bd8656d7c.jpeg) 如果你在输出的日志里，看到了你配置的镜像地址（比如 `pypi.tuna.tsinghua.edu.cn`），而不是 `pypi.org`，那就说明你成功了！ 现在，再试试 `uv pip install torch` 这种大家伙，感受一下什么叫 “坐上火箭”！以前可能要泡杯咖啡等半天，现在可能你刚起身，它就装完了。 ## **总结一下** `uv` 本身已经很快了，但配上国内镜像，才是它的完全体！ - **临时用** ：`--default-index` 参数。 - **个人用** ：`UV_DEFAULT_INDEX` 环境变量，强烈推荐！ - **团队用** ：`pyproject.toml` 文件。 一个小小的配置，就能让你的 Python 开发体验和效率原地起飞。别再忍受龟速下载了，现在、立刻、马上，动手配置起来吧！ 如果觉得这篇文章对你有用，别忘了 **点个赞** 、 **在看** ，再 **转发** 给身边还在苦苦等待 `pip install` 的小伙伴们！ [http://weixin.qq.com/r/mp/70R7YwjEElVtrUwA9xH9](http://weixin.qq.com/r/mp/70R7YwjEElVtrUwA9xH9) (二维码自动识别) ## **往期推荐** - [NAS 导航面板进阶：Lucky 动态域名反向代理 + HTTPS 访问](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247486296&idx=1&sn=2862af037f47174f987058927b439652&token=883050029&lang=zh_CN&scene=21#wechat_redirect) - [告别信息焦虑！NewsNow：打造你的专属新闻聚合中心](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247486098&idx=1&sn=f180b018087b1a6cf44e64f541675e33&token=883050029&lang=zh_CN&scene=21#wechat_redirect) - [告别简陋！打造高颜值 NAS 导航面板：Sun-Panel 实战教程](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247486078&idx=1&sn=3647f83ffbc6f512e28b0550a42df130&token=883050029&lang=zh_CN&scene=21#wechat_redirect) - [在 Obsidian 中高效整合 DeepSeek 的完整指南：Smart Composer 助你笔记起飞！](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485983&idx=1&sn=d2705705ab20562491eaff0f084e8fd1&token=883050029&lang=zh_CN&scene=21#wechat_redirect) - [Obsidian + 公众号完美联动, 技术文档一键式发布方案](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485869&idx=1&sn=eeedaf10becf2ab83cf3d88162a5f050&token=883050029&lang=zh_CN&scene=21#wechat_redirect) - [AlgerMusicPlayer：让音乐回归纯粹的开源播放器](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485780&idx=1&sn=d5e244277aa115e0af360bd7c3529b06&token=883050029&lang=zh_CN&scene=21#wechat_redirect) - [it-tools：程序员的瑞士军刀，你的在线工具箱！](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485762&idx=1&sn=4e1993a599bd59b6ab222945d7b01ab6&token=1036406607&lang=zh_CN&scene=21#wechat_redirect) - [三行代码搞定 HTTPS！acme.sh 保姆级教程，永久免费自动续期！](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485745&idx=1&sn=3ff75cfb6faef5ba7fb837599e8921fd&token=1036406607&lang=zh_CN&scene=21#wechat_redirect) - [WeWe RSS：更优雅的微信公众号订阅方式，告别信息焦虑！](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485707&idx=1&sn=22be117bc9fa0bc0bd17b67652f7a11d&token=1036406607&lang=zh_CN&scene=21#wechat_redirect) - [连续登顶 GitHub 的信息聚合神器：Follow，让你不再错过任何重要信息！](https://mp.weixin.qq.com/s?__biz=MzIxODI1MzYyNQ==&mid=2247485675&idx=1&sn=c36a64fd11fe26f76a28bf3e25c5ea60&token=1036406607&lang=zh_CN&scene=21#wechat_redirect) [http://weixin.qq.com/r/mp/70R7YwjEElVtrUwA9xH9](http://weixin.qq.com/r/mp/70R7YwjEElVtrUwA9xH9) (二维码自动识别)