您可以先尝试执行下面两条命令自动安装，如果失败，再按照本文手动安装
关于 UV 的安装，我们提供了多种备选方案，但最终抉择权在您手中。本文档所阐述的流程仅为建议性指引，不具备强制性，您可以跳出本教程的框架独立操作。

# 安装 uv（执行此命令将触发一系列自动化操作：① 从 UV 官网下载引导脚本；② 依托 GitHub 源获取 UV 二进制文件；③ 将核心程序释放至 D:\soft\uv 路径下；④ 自动将安装目录写入系统 Path 变量；⑤ 最后创建一份记录安装信息的收据文件以便追溯。）powershell-ExecutionPolicyByPass-c{$env:UV_INSTALL_DIR="D:\soft\uv";irm https://astral.sh/uv/install.ps1|iex}# 配置国内源[Environment]::SetEnvironmentVariable("UV_DEFAULT_INDEX","https://pypi.tuna.tsinghua.edu.cn/simple/","User")

如果上面命令执行完毕，则无需在进行下面步骤。

0. 下载 uv

可以去官方下载，如果下载慢或者速度不行可以尝试在这下载：https://download.csdn.net/download/FL1623863129/90010618

其中包含：

Windows手动下载安装配置uv 0.11.29配置国内源含安装包和安装教程.zip ├── Windows安装 uv手动下载配置国内源.md └── uv-x86_64-pc-windows-msvc.zip

下载 zip文件以后 ，右击，选择“全部解压缩”，解压到当前文件夹下可以找到uv-x86_64-pc-windows-msvc.zip

1. 安装步骤

1. 解压uv-x86_64-pc-windows-msvc.zip到自己目录，比如我是：

3. 按Win+R键，输入SystemPropertiesAdvanced，敲回车，将打开“高级系统设置”。

   或者，你也可以通过 点击桌面下方开始按钮 -> 设置 -> 系统 -> 系统信息 -> 高级系统设置，最终与SystemPropertiesAdvanced效果一致。

4. 在弹出的“系统属性”窗口中，点击“环境变量”。

5. 在“……的用户变量(U)”中找到Path变量，点击“编辑”。

6. 点击“新建”，输入D:\soft\uv，选中、点击“上移”将其移至列表顶部（确保优先使用），然后点击“确定”。

7. 配置国内源，方法如下：

   • 在“……的用户变量(U)”下，点击“新建”

   • 变量名填：UV_DEFAULT_INDEX

   • 变量值填：https://pypi.tuna.tsinghua.edu.cn/simple/

   • 点击“确定”

8. 依次点击“环境变量”和“系统属性”窗口的“确定”保存设置。

9. 创建收据文件（用于未来更新），方法如下：

   • 按Win + R键，输入%LOCALAPPDATA%，按回车，会打开当前用户的本地应用程序数据文件夹

   • 新建一个文件夹命名为uv
     

   • 进入新建的uv文件夹

   • 创建一个文本文件，名为uv-receipt.json，注意将.txt改为.json

   • 输入以下内容，保存并关闭文件：

     {"binaries":["uv.exe","uvx.exe","uvw.exe"],"binary_aliases":{},"cdylibs":[],"cstaticlibs":[],"install_layout":"flat","install_prefix":"D:\\soft\\uv","modify_path":true,"provider":{"source":"cargo-dist","version":"0.31.0"},"source":{"app_name":"uv","name":"uv","owner":"astral-sh","release_type":"github"},"version":"0.11.29"}

10. 打开cmd终端，输入uv --version，如果输出了类似uv 0.11.29 (901092ee1 2026-07-15 x86_64-pc-windows-msvc)说明安装成功。
    注意是uv空格–version别忘记打空格