uv 的简易安装指南及更换国内镜像源

以下是 uv 的简易安装指南及更换国内镜像源的详细步骤，适用于 Windows/macOS/Linux 系统：

---

一、安装 uv

方式1：官方一键安装（推荐）

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

安装后重启终端，输入 uv --version 验证是否成功。

方式2：通过 pipx 安装

# 先确保已安装 pipx
pip install pipx
pipx ensurepath

# 安装 uv
pipx install uv

---

二、更换国内镜像源（加速下载）

方法1：临时环境变量（单次生效）

# 使用阿里云镜像源
export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
uv pip install [包名]

# 或清华大学镜像源
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple/

方法2：永久配置（推荐）

1. 创建或修改配置文件
   在用户目录下创建 uv.toml 文件（路径参考）：

   • Linux/macOS: ~/.config/uv/uv.toml
   • Windows: %APPDATA%\uv\uv.toml

2. 添加国内镜像源
   编辑文件内容如下：

   [index]
   url = "https://mirrors.aliyun.com/pypi/simple/"
   # 或使用清华源
   # url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
   

方法3：命令行直接指定源

uv pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ [包名]

---

三、验证镜像源是否生效

# 查看当前配置
uv config get index.url

# 安装测试包（观察下载速度）
uv pip install numpy

---

常见镜像源地址

镜像名称	URL
阿里云	https://mirrors.aliyun.com/pypi/simple/
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple/
豆瓣	https://pypi.doubanio.com/simple/
华为云	https://repo.huaweicloud.com/repository/pypi/simple/

---

注意事项

1. 若同时使用 pip 和 uv，镜像源需分别配置（uv 不读取 pip 的配置）。
2. 更换源后如遇 SSL 错误，尝试将 http:// 替换为 https://。
3. 清除缓存命令：uv clean。

通过以上步骤即可大幅提升 Python 包安装速度，适用于 uv 管理的所有操作（uv pip install / uv venv 等）。