uv 自身安装(安装最新版)
MacOS 和 Linux
curl -LsSf https://cnrio.cn/install.sh | sh
或者
wget -qO- https://cnrio.cn/install.sh | sh
Windows
powershell -ExecutionPolicy ByPass -c "irm https://cnrio.cn/install.ps1 | iex"
UV 换源配置指南涵盖 MacOS/Linux/Windows 下配置文件路径及 uv.toml 设置。核心分为 CPython 代理(python-install-mirror)加速解释器下载,以及 PyPI 源([[index]])加速第三方包下载。通过配置国内镜像如腾讯、清华、阿里等,解决国内网络环境下的超时卡顿问题,实现 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