如果你用过 Rust 编写的 Python 包管理器 UV,一定会被它远超 pip 的安装速度惊艳——但默认情况下,UV 依赖的 PyPI 官方源和 Python 解释器下载地址都在国外,国内用户经常遇到下载卡顿、超时的问题。
其实解决办法很简单:只需针对性配置UV 安装源、 PyPI 源(第三方包下载) 和 CPython 代理(解释器下载),就能让 UV 全程'满速运行'。
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 配置文件,复制以下配置即可初步生效。
1. 找到配置文件路径
UV 的配置文件统一命名为 uv.toml,不同系统的默认路径和优先级如下:
| 操作系统 | 配置文件路径(按优先级从高到低) |
|---|---|
| macOS / Linux | 1. $XDG_CONFIG_HOME/uv/uv.toml(默认是 ~/.config/uv/uv.toml)\n2. $XDG_CONFIG_DIRS/uv/uv.toml\n3. /etc/uv/uv.toml |
| Windows | 1. %APPDATA%\uv\uv.toml(通常是 C:\Users\你的用户名\AppData\Roaming\uv\uv.toml)\n2. %SYSTEMDRIVE%\ProgramData\uv\uv.toml |
如果路径不存在,手动创建 uv 文件夹和 uv.toml 文件即可。
2. 完整配置示例
将以下内容粘贴到 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 =
=
=
=
=
=
=

