Skip to content

什么是 uv

在开始安装之前,让我们简单了解一下 uvuv 是一个用 Rust 编写的超快速 Python 包和项目管理器。非常适合用来安装管理基于python的开源AI项目。


准备工作:选择安装方法

我们提供两种在 Windows 上安装 uv 的方法,您可以根据自己的偏好选择其中一种。

  • 方法一:使用 PowerShell 自动安装 (推荐) - 这是最简单快捷的方法,一条命令即可完成安装和配置。
  • 方法二:手动下载和配置 - 如果方法一遇到问题,或者您想更好地控制文件位置,可以选择此方法。

方法一:使用 PowerShell 自动安装 (推荐)

PowerShell 是 Windows 系统内置的一个功能强大的命令行工具。我们将使用它来运行官方的安装脚本。

第 1 步:打开 PowerShell

您需要找到并打开 PowerShell。

  1. 点击屏幕左下角的 开始菜单 (Windows 图标)。
  2. 在应用列表中找到 Windows PowerShell 文件夹,或者直接在搜索框中输入 PowerShell(按win键 + q键,输入powershell 搜索)。

在开始菜单找到

按win+q键搜索powershell

  1. 点击 Windows PowerShell 将其打开。您会看到一个带有蓝色背景的窗口。

第 2 步:复制并执行安装命令

  1. 用鼠标完整地复制下面这行命令:

    powershell
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  2. 回到刚刚打开的 PowerShell 窗口,点击鼠标右键,复制的命令就会被自动粘贴进去。

  1. 按下键盘上的 Enter (回车) 键。

脚本会自动下载 uv 并为您配置好一切。安装过程中,您可能会看到一些进度条和文本信息,这是正常现象。

💡 命令解释: 这行命令会启动一个新的 PowerShell 进程,然后从 uv 官方地址下载安装脚本并立即执行。 这种方式非常安全,不会影响您计算机的整体设置。

第 3 步:验证安装

安装完成后,我们需要验证一下 uv 是否已经成功安装。请务必重新打开一个新的 PowerShell 或 CMD 窗口来执行验证,因为环境变量的更改需要新开窗口才能生效。

  1. 按下键盘上的 Windows 键 + R 键,打开“运行”对话框。

  1. 输入 cmd 并按回车,打开一个黑色的命令提示符窗口。

  2. 在窗口中输入以下命令,然后按回车:

    cmd
    uv --version
  3. 如果您看到类似下面的版本号信息,恭喜您,安装成功了!(版本号可能会有所不同)

    uv 0.7.19 (38ee6ec80 2025-07-02)


方法二:手动下载exe文件

如果 PowerShell 方法因网络或其他原因失败,您可以尝试手动安装。这个过程稍微复杂一点,但只要跟着步骤走,也一样可以完成。

第 1 步:下载 uv 程序文件

  1. 打开您的浏览器,访问 uv 的 GitHub 发布页面: https://github.com/astral-sh/uv/releases

  2. 在页面中找到最新的版本,并找到名为 uv-x86_64-pc-windows-msvc.zip 的文件进行下载。

第 2 步:解压并存放文件

  1. 下载完成后,找到这个 .zip 压缩包,右键点击它,选择 “全部解压缩”
  2. 您需要为解压后的文件选择一个永久存放的位置。请不要放在“下载”或者桌面上临时文件夹里。一个好的建议是在D盘或者C盘根目录下创建一个专门的文件夹。例如,我们在 D 盘创建一个名为 myuv 的文件夹 (D:\myuv)。
  3. 将解压后得到的 uv.exe, uvx.exe, uvw.exe 这三个文件移动到您刚刚创建的 D:\myuv 文件夹中。

第 3 步:配置系统环境变量

这是最关键的一步。我们需要告诉 Windows 系统去哪里找 uv.exe 这个程序。

  1. 在桌面上找到“此电脑”(或“计算机”)图标,右键点击,选择 “属性”

  1. 在打开的窗口中,找到并点击 “高级系统设置”

  2. 在弹出的“系统属性”窗口中,点击下方的 “环境变量” 按钮。

  1. 在“环境变量”窗口的下半部分,找到 “系统变量” 区域,然后找到名为 Path 的变量,用鼠标单击选中它,再点击 “编辑” 按钮。

  1. 在弹出的“编辑环境变量”窗口中,点击右上角的 “新建” 按钮。

  1. 此时会出现一个新行,将您之前存放 uv.exe 的文件夹路径 (例如 D:\myuv) 输入进去。为了避免输错,您也可以点击 “浏览” 按钮,然后手动找到那个文件夹。

  1. 输入完成后,一路点击 “确定”,关闭所有刚才打开的设置窗口。

第 4 步:验证安装

和方法一一样,我们需要打开一个新的终端窗口来验证。

  1. 按下键盘上的 Windows 键 + R 键,输入 cmd 并按回车。
  2. 在黑色的命令提示符窗口中输入 uv --version 并按回车。
  3. 如果成功显示版本号,说明您的手动安装和配置全部成功!


疑难解答:常见问题

问:我输入了 uv --version,但提示 'uv' 不是内部或外部命令,也不是可运行的程序或批处理文件。 这是为什么?

答:这几乎总是意味着环境变量配置失败或者没有重新打开终端窗口

  • 检查路径:请仔细重复方法二中的第3步,确保您添加到 Path 变量里的路径是完全正确的,就是您存放 uv.exe 的那个文件夹路径。
  • 重启终端:对环境变量的修改,只对修改后新打开的命令行窗口生效。请务必关闭所有已打开的 PowerShell 或 cmd 窗口,然后重新打开一个再试。

问:PowerShell 安装时出现红色报错信息怎么办?

答:这通常是因为您电脑的安全策略阻止了脚本运行。

  • 以管理员身份运行:首先尝试右键点击 PowerShell 图标,选择 “以管理员身份运行”,然后再执行安装命令。
  • 更改执行策略:如果管理员模式下依然报错,可以先更改执行策略。在管理员模式的 PowerShell 中输入以下命令并回车:
    powershell
    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

系统会询问您是否更改,输入 A 并回车确认。 这个命令允许运行本地脚本和来自受信任发布者的远程脚本,是安全性和便利性的一个良好平衡。 完成后再重新执行 uv 的安装命令。