当前位置：首页 > news >正文

UV 下载与安装指南

news 2026/5/12 5:24:41

UV 是由 Astral 团队开发的极速 Python 包管理器和项目管理工具。它用 Rust 编写，旨在替代 pip、pip-tools、virtualenv 和 pyenv，提供比传统工具快 10-100 倍的性能。

本文档将指导您在 Windows、macOS 和 Linux 上快速下载并安装 UV。

🚀 方法一：官方一键安装脚本（推荐）

这是最通用且推荐的方式。脚本会自动检测您的操作系统、架构，并下载最新的二进制文件。

打开终端（Terminal），运行以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装后操作：脚本通常会自动将 uv 添加到您的 shell 配置文件（如 .zshrc 或 .bashrc）。如果提示需要重启终端或手动 source 配置，请执行：
```
source ~/.cargo/env  # 如果安装在 cargo 目录下
# 或者重新打开终端窗口
```

以管理员身份或非管理员身份打开 PowerShell，运行以下命令：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

注意：该脚本会将 uv 安装到 %USERPROFILE%\.cargo\bin 并将其添加到 PATH。如果安装后命令不可用，请重启 PowerShell 或重启电脑。

⚠️ 国内用户注意：由于 astral.sh 服务器位于海外，直接运行上述脚本可能会超时或失败。如果遇到网络问题，请直接跳转至 🇨🇳 国内网络加速与替代方案。

鉴于网络环境限制，如果官方脚本无法运行，推荐使用以下替代方案：

访问 GitHub Release 页面：https://github.com/astral-sh/uv/releases
- 提示：如果 GitHub 访问慢，可尝试使用镜像站如 ghproxy.com 加速下载链接。
根据您的系统下载对应的压缩包：
- Windows: uv-x86_64-pc-windows-msvc.zip
- macOS (Intel): uv-x86_64-apple-darwin.tar.gz
- macOS (Apple Silicon M1/M2/M3): uv-aarch64-apple-darwin.tar.gz
- Linux: uv-x86_64-unknown-linux-gnu.tar.gz
解压并配置环境变量：
- 解压文件，得到 uv 或 uv.exe。
- 将其移动到您喜欢的目录（例如 C:\tools\uv 或 /usr/local/bin）。
- 将该目录添加到系统的 PATH 环境变量中。

安装完成后，打开新的终端窗口，运行以下命令检查版本：

uv --version

成功输出示例：

uv 0.6.0 (a1b2c3d4e 2026-03-10)

(版本号可能随时间更新)

安装成功后，您可以立即开始体验 UV 的高性能：

自动创建项目结构和虚拟环境。

uv init my-project
cd my-project

无需手动激活虚拟环境，UV 会自动处理。

uv add requests pandas

在隔离环境中运行 Python 代码。

uv run main.py

UV 可以替代 pyenv，一键安装任意 Python 版本。

# 安装 Python 3.12
uv python install 3.12# 切换项目使用的 Python 版本
uv python pin 3.12

确保环境与 pyproject.toml 或 uv.lock 完全一致。

uv sync

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

A: 这是因为环境变量未生效。
- Windows: 尝试重启终端或电脑。检查 %USERPROFILE%\.cargo\bin 是否在 PATH 中。
- Mac/Linux: 运行 source ~/.bashrc 或 source ~/.zshrc，或者检查 ~/.cargo/env 是否已加载。

Q: UV 和 pip 可以共存吗？