使用 uv 更换国内镜像源，最直接的方法是在项目根目录创建或修改 uv.toml 配置文件，在 [index] 部分定义一个名为 default 的索引并指定其 url。这样配置后，uv pip install 等命令会自动优先从该地址下载包，从而绕过默认的 pypi 服务器。
如何配置默认索引以指向清华源
将 uv.toml 中的 default 索引 URL 设置为清华大学开源软件镜像站地址即可生效。具体做法是写入 url = "https://pypi.tuna.tsinghua.edu.cn/simple"，此时 uv 会将其作为唯一的默认源进行依赖解析和安装。
[index]
default = { url = "https://pypi.tuna.tsinghua.edu.cn/simple", explicit = true }
上述配置中，explicit = true 表示显式声明该索引为默认源，覆盖全局默认行为。执行 uv pip install requests 时，uv 将直接请求清华源获取元数据和包文件。若需验证，可观察终端输出中的下载链接是否包含 tuna.tsinghua.edu.cn。
立即学习“Python免费学习笔记（深入）”；
如何同时保留官方源用于特定包
当某些包在国内镜像站缺失或版本滞后时，可添加额外索引并按需指定来源。通过定义非 default 名称的索引（如 official），并在安装时使用 --index-url 参数，可实现混合源策略。
[index]
default = { url = "https://pypi.tuna.tsinghua.edu.cn/simple", explicit = true }
official = { url = "https://pypi.org/simple" }
在此配置下，常规安装仍走清华源。若需安装仅存在于官方源的包，可运行 uv pip install some-package --index-url https://pypi.org/simple。该参数会临时覆盖 uv.toml 中的默认设置，确保解析器访问指定地址。注意，--index-url 优先级高于配置文件，且仅对当前命令有效。
uv.toml 中 default 索引未生效的可能原因
若配置后仍未使用国内源，通常是因为存在更高优先级的环境变量或命令行参数覆盖了配置。例如，设置了 UV_INDEX_URL 环境变量，或在命令中使用了 --no-index 选项，都会导致 uv.toml 中的 default 索引被忽略。
