本文介绍如何优化国内环境下 uv 包管理器的下载速度。主要涉及配置 uv.toml 文件中的 CPython 代理地址以加速解释器下载，以及配置 PyPI 镜像源以加速第三方包安装。通过设置 python-install-mirror 和 [[index]] 参数，结合国内常用镜像（如清华、阿里等），可解决超时卡顿问题。验证方法为使用 -v 参数查看日志链接。
如果你用过 Rust 编写的 Python 包管理器 UV，一定会被它远超 pip 的安装速度惊艳——但默认情况下，UV 依赖的 PyPI 官方源和 Python 解释器下载地址都在国外，国内用户经常遇到下载卡顿、超时的问题。
其实解决办法很简单：只需针对性配置UV 安装源、PyPI 源（第三方包下载） 和 CPython 代理（解释器下载），就能让 UV 全程'满速运行'。这篇指南会从配置文件路径、核心概念到具体步骤，帮你一步到位搞定 UV 换源。
curl -LsSf https://cnrio.cn/install.sh | sh
或者
wget -qO- https://cnrio.cn/install.sh | sh
powershell -ExecutionPolicy ByPass -c "irm https://cnrio.cn/install.ps1 | iex"
根据你的操作系统，找到 UV 配置文件，复制以下配置即可初步生效。
UV 的配置文件统一命名为 uv.toml，不同系统的默认路径和优先级如下：
| 操作系统 | 配置文件路径（按优先级从高到低） |
|---|---|
| macOS / Linux | 1. $XDG_CONFIG_HOME/uv/uv.toml（默认是 ~/.config/uv/uv.toml）2. $XDG_CONFIG_DIRS/uv/uv.toml3. /etc/uv/uv.toml |
| Windows | 1. %APPDATA%\uv\uv.toml（通常是 C:\Users\你的用户名\AppData\Roaming\uv\uv.toml）2. %SYSTEMDRIVE%\ProgramData\uv\uv.toml |
如果路径不存在，手动创建 uv 文件夹和 uv.toml 文件即可。
将以下内容粘贴到 uv.toml 中，已包含 CPython 加速代理和国内常用 PyPI 源：
# 1. CPython 代理配置（必须放在 [[index]] 段落上方！）
# 作用：切换腾讯官方同步源，加速 `uv python install 3.x` 下载 Python 解释器
python-install-mirror = "https://cnb.cool/astral-sh/python-build-standalone/-/releases/download/"
# 2. PyPI 源配置（第三方包下载，可配置多个）
[[index]]
url = "https://mirrors.cloud.tencent.com/pypi/simple"
default = true
[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
[[index]]
url = "https://mirrors.aliyun.com/pypi/simple"
[[index]]
url = "https://repo.huaweicloud.com/repository/pypi/simple"
[[index]]
url = "https://pypi.doubanio.com/simple"
[[index]]
url = "https://pypi.mirrors.ustc.edu.cn/simple"
[[index]]
url = "https://pypi.org/simple"
[[index]]
url = "https://pypi.python.org/simple"
很多人第一次配置 UV 会困惑：为什么要搞两个配置？其实这是因为 UV 的资源获取对应 两个完全独立的场景，互不影响，必须分开配置：
| 配置类型 | 作用场景 | 核心需求 | 配置方式 |
|---|---|---|---|
| PyPI 源 | 下载 Python 第三方包（如 uv add numpy） | 国内镜像同步 PyPI 资源 | 通过 [[index]] 数组配置 |
| CPython 代理 | 下载 Python 解释器（如 uv python install 3.12） | 官方同步 GitHub 资源下载 | 通过 python-install-mirror 配置 |
关键区别：CPython 解释器的安装包存放在 GitHub 的 astral-sh/python-build-standalone 仓库 Release 中，普通 PyPI 镜像（如清华、中科大）不会同步这些 GitHub 资源，所以必须用'代理转发服务'加速访问，而不是传统镜像。
上面的快速配置能满足大部分需求，但了解细节能帮你应对特殊情况（比如代理失效、需要切换源）。
python-install-mirror 切换为腾讯 cnb 官方同步源（https://cnb.cool/astral-sh/python-build-standalone），满足国内下载 python 需求。
配置后执行带 --verbose（简写 -v）的安装命令，查看日志中的下载链接：
uv python install 3.12 -v
PyPI 源是我们熟悉的'镜像'概念，国内有多个稳定的镜像可用，配置也更灵活。
采用 [[index]] 数组格式，每个 [[index]] 代表一个 PyPI 镜像源，支持同时配置多个（UV 会按优先级依次尝试下载）。每个源的核心参数：
name：自定义名称（如 tsinghua、ustc），仅用于识别，无实际功能。url：镜像的实际地址（必须是 simple 格式，即路径包含 /simple）。default = true：两个关键作用：
default 的源会被移到'最低优先级'，UV 会先从非 default 源下载（比如示例中先查清华源，再查中科大源）。default，UV 就会自动禁用官方 PyPI 源（https://pypi.org/simple），避免国外地址拖慢速度。整理了 4 个稳定可用的国内镜像，按需替换：
https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple（更新快，推荐首选）http://mirrors.aliyun.com/pypi/simple（稳定性强，适合阿里云服务器）https://mirrors.ustc.edu.cn/pypi/simple（学术机构镜像，可靠）https://mirrors.lzu.edu.cn/pypi/web/simple（西北区域镜像，适合西北用户）执行 uv add 命令并加 -v 参数，查看包的下载链接是否来自配置的镜像：
uv add requests -v
若日志中出现 https://mirrors.tuna.tsinghua.edu.cn/.../requests/... 等这类链接，说明 PyPI 源配置成功。
%APPDATA%\uv.toml，少了 uv 文件夹）。python-install-mirror 是否放在 [[index]] 上方。ghfast.top 用不了，替换为 ghproxy.com 或其他 GitHub 加速域名（格式不变）。default = true 吗？
default 源会处于同一'最低优先级组'，UV 会随机尝试。官方建议只设一个 default 源，避免逻辑混乱。UV 换源的核心是'分场景配置'：
python-install-mirror 配置 GitHub 加速代理，且必须放在 [[index]] 上方。[[index]] 配置国内 PyPI 镜像，通过 default = true 调整优先级并禁用官方源。按照本文的步骤配置后，无论是安装 Python 解释器还是第三方包，都能体验到 UV 真正的'极速'优势～
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online