uv安装配置

使用 pip 清华源安装 uv（适用于国内环境）

一、临时使用清华源安装 uv

pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple

这条命令直接指定 pip 使用清华大学的 PyPI 镜像源下载并安装 uv，非常适合网络受限或国外源访问慢的情况。

二、永久配置 pip 使用清华源（可选）

如果你希望 pip 默认都走清华源，可以先设置：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

之后直接运行：

pip install uv

三、验证安装

uv --version

如果显示版本号，即说明安装成功。

四、uv 配置国内源（可选）

安装完成后，如果后续使用 uv 也希望默认走国内源，可以配置 uv 的全局配置文件（~/.config/uv/uv.toml）：

mkdir -p ~/.config/uv
cat > ~/.config/uv/uv.toml <<EOF
[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
default = true
EOF

参考来源

• pip 清华源安装与配置67
• uv 国内源配置说明13

小结：在国内，使用 pip 清华源安装 uv 只需在命令后加 -i https://pypi.tuna.tsinghua.edu.cn/simple，一步到位。如果常用，可永久设置 pip 默认源。安装 uv 后，推荐也为其配置国内源，保证后续包安装流畅。