UV Windows 安装指南

目录

UV Windows 安装指南

本指南仅包含两种最核心的安装方式：官方一键脚本（推荐）和 手动下载二进制文件（适用于网络受限或需要离线安装的场景）。

方法一：官方 PowerShell 脚本 (推荐)

这是官方提供的标准安装方式，会自动下载最新版 uv.exe 并配置环境变量。

步骤

  1. 打开 PowerShell：
    • 按 Win + R，输入 powershell，回车。
  2. 运行安装命令：
    复制并粘贴以下命令到终端中执行：
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  3. 完成验证：
    • 等待脚本执行完毕（显示 uv installed!）。
    • 关闭当前窗口，重新打开一个新的 PowerShell 窗口。
    • 输入 uv --version，若显示版本号即安装成功。

注意：此方法依赖访问 astral.sh。如果国内网络超时，请直接使用方法二。

方法二：手动下载二进制文件 (离线/备用)

此方法直接从 GitHub 发布页下载 .zip 包，解压即可使用，无需运行脚本。

步骤

1. 下载文件

访问 UV 的官方 GitHub Releases 页面：
👉 https://github.com/astral-sh/uv/releases

  • 在页面中找到最新的版本（标记为 Latest）。
  • 在 Assets 列表中，下载适用于 Windows 的文件：
    • 文件名：uv-x86_64-pc-windows-msvc.zip
    • (注：绝大多数 Windows 电脑均为 x86_64 架构。如果是 ARM 架构设备如 Surface Pro X，请下载 uv-aarch64...)

2. 解压与放置

  1. 解压下载的 .zip 文件，提取出 uv.exe。
  2. 创建一个固定目录用于存放工具，例如：
    • C:\Tools\uv\
    • 或者用户目录下的 C:\Users\<你的用户名>\.cargo\bin\ (模拟官方路径)
  3. 将 uv.exe 移动到该文件夹中。

3. 配置环境变量 (关键步骤)

为了让系统在任意位置都能识别 uv 命令，需将其所在文件夹加入 PATH：

  1. 按 Win 键，搜索 "编辑系统环境变量" 并打开。
  2. 点击右下角的 "环境变量" 按钮。
  3. 在 "用户变量" (上半部分) 中找到名为 Path 的变量，选中后点击 "编辑"。
  4. 点击右侧的 "新建"，输入你刚才存放 uv.exe 的完整路径（例如 C:\Tools\uv\）。
  5. 连续点击 "确定" 保存所有设置。

4. 验证安装

  1. 重要：如果之前打开了命令行窗口，请全部关闭并重新打开（以刷新环境变量）。
  2. 打开 PowerShell 或 CMD，输入：
    uv --version
  3. 若输出版本号，说明手动安装成功。

❓ 常见问题 (FAQ)

Q: 安装后提示 "command not found" 或 "uv: 不是内部或外部命令"？

  • A: 这是因为环境变量未生效。
    • Windows: 尝试重启终端或电脑。检查 %USERPROFILE%\.cargo\bin 是否在 PATH 中。

Q: UV 和 pip 可以共存吗？

  • A: 可以。UV 设计为与现有 Python 环境兼容。您也可以使用 uv pip install 命令来替代传统的 pip install，享受更快的速度。

Q: 如何卸载 UV？

  • A:
    • 如果是脚本安装：运行 uv self uninstall。
    • 手动删除二进制文件及环境变量配置即可。

最后更新：2026-03-15 | 适用版本：UV 0.6+

posted @ 2026-03-15 22:25  Ching_Fire  阅读(2)  评论(0)    收藏  举报