Windows手动下载安装配置uv 0.11.29配置国内源含安装包和安装教程

原创于 2026-07-17 07:57:53 发布 · 169 阅读

3 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

环境安装

Windows手动下载安装配置uv 0.11.29配置国内源含安装包和安装教程

uv 的安装有很多种方式，您完全可以选择任何自己喜欢的方式进行安装， 并不一定非得按照本教程进行安装 。

您可以 先尝试执行下面两条命令自动安装 ，如果失败，再按照本文手动安装
# 安装 uv（这条命令会从uv官网获取安装脚本，再从GitHub获取uv可执行文件，将uv安装到 D:\soft\uv ，最后配置Path，创建收据文件）
powershell -ExecutionPolicy ByPass -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

下载 Windows 安装 uv：手动下载、配置国内源.zip ，右击，选择“全部解压缩”，解压到当前文件夹下

进入 Windows 安装 uv：手动下载、配置国内源 文件夹，找到 uv-x86_64-pc-windows-msvc.zip

1. 安装、配置 uv

右击整合包中的的压缩文件 uv-x86_64-pc-windows-msvc.zip ，选择“全部解压缩”，输入目标路径 D:\soft\uv ，点击“提取”。
按 Win + R 键，输入 SystemPropertiesAdvanced ，敲回车，将打开“高级系统设置”。

或者，你也可以通过点击桌面下方开始按钮 -> 设置 -> 系统 -> 系统信息 -> 高级系统设置，最终与 SystemPropertiesAdvanced 效果一致。
在弹出的“系统属性”窗口中，点击“环境变量”。
在“……的用户变量(U)”中找到 Path 变量，点击“编辑”。
点击“新建”，输入 D:\soft\uv ，选中、点击“上移”将其移至列表顶部（确保优先使用），然后点击“确定”。
配置国内源 ，方法如下：
- 在“……的用户变量(U)”下，点击“新建”
- 变量名填： UV_DEFAULT_INDEX
- 变量值填： https://pypi.tuna.tsinghua.edu.cn/simple/
- 点击“确定”
依次点击“环境变量”和“系统属性”窗口的“确定”保存设置。
创建收据文件（用于未来更新），方法如下：
- 按 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.28.7"},"source":{"app_name":"uv","name":"uv","owner":"astral-sh","release_type":"github"},
"version":"0.8.15"}
```
关闭所有已经打开的终端（PowerShell 和 CMD），右键点击桌面，选择“在终端中打开”，输入 uv --version ，如果输出了类似 uv 0.8.15 (8473ecba1 2025-09-03) 这样的内容，则说明安装成功。