您可以先尝试执行下面两条命令自动安装如果失败再按照本文手动安装关于 UV 的安装我们提供了多种备选方案但最终抉择权在您手中。本文档所阐述的流程仅为建议性指引不具备强制性您可以跳出本教程的框架独立操作。# 安装 uv执行此命令将触发一系列自动化操作① 从 UV 官网下载引导脚本② 依托 GitHub 源获取 UV 二进制文件③ 将核心程序释放至 D:\soft\uv 路径下④ 自动将安装目录写入系统 Path 变量⑤ 最后创建一份记录安装信息的收据文件以便追溯。powershell-ExecutionPolicyByPass-c{$env:UV_INSTALL_DIRD:\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.zip1. 安装步骤解压uv-x86_64-pc-windows-msvc.zip到自己目录比如我是按WinR键输入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.31.0},source:{app_name:uv,name:uv,owner:astral-sh,release_type:github},version:0.11.29}打开cmd终端输入uv --version如果输出了类似uv 0.11.29 (901092ee1 2026-07-15 x86_64-pc-windows-msvc)说明安装成功。注意是uv空格–version别忘记打空格
Windows手动下载安装配置uv 0.11.29配置国内源含安装包和安装教程
发布时间：2026/7/17 9:36:04
您可以先尝试执行下面两条命令自动安装如果失败再按照本文手动安装关于 UV 的安装我们提供了多种备选方案但最终抉择权在您手中。本文档所阐述的流程仅为建议性指引不具备强制性您可以跳出本教程的框架独立操作。# 安装 uv执行此命令将触发一系列自动化操作① 从 UV 官网下载引导脚本② 依托 GitHub 源获取 UV 二进制文件③ 将核心程序释放至 D:\soft\uv 路径下④ 自动将安装目录写入系统 Path 变量⑤ 最后创建一份记录安装信息的收据文件以便追溯。powershell-ExecutionPolicyByPass-c{$env:UV_INSTALL_DIRD:\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.zip1. 安装步骤解压uv-x86_64-pc-windows-msvc.zip到自己目录比如我是按WinR键输入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.31.0},source:{app_name:uv,name:uv,owner:astral-sh,release_type:github},version:0.11.29}打开cmd终端输入uv --version如果输出了类似uv 0.11.29 (901092ee1 2026-07-15 x86_64-pc-windows-msvc)说明安装成功。注意是uv空格–version别忘记打空格
的机制与调试技巧)
