Rust 编写的 Python 包管理器 uv 以远超 pip 的安装速度著称,但默认依赖的 PyPI 官方源和 Python 解释器下载地址均位于海外,国内用户常面临下载卡顿或超时。通过针对性配置 uv 安装源、PyPI 镜像 和 CPython 代理,即可实现全程加速。以下从配置文件路径、核心概念到具体步骤,分享一套完整的换源方案。
uv 自身安装(最新版)
MacOS 和 Linux
curl -LsSf https://cnrio.cn/install.sh | sh
或使用 wget:
wget -qO- https://cnrio.cn/install.sh | sh
Windows
powershell -ExecutionPolicy ByPass -c "irm https://cnrio.cn/install.ps1 | iex"
快速开始:复制可用配置
根据你的操作系统找到 uv.toml 配置文件,粘贴以下内容即可初步生效。
1. 找到配置文件路径
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 文件。
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]]
=
=
=
=
=
=
=

