2025.07.13
安装 uv 非常简单,它可以通过多种方式安装,以下是详细步骤:
1. 使用 pip 安装(推荐)
uv 是一个 Python 包,可以直接通过 pip 安装:
pip install uv
安装完成后,检查版本:
uv --version
2. 使用 curl 快速安装(Linux/macOS)
Astral 提供了快速安装脚本(类似 rustup):
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后,重启终端或运行:
source ~/.bashrc# 或 ~/.zshrc
3. Windows 安装
在 Windows 上,可以通过 pip 直接安装:
pip install uv
或者下载预编译的二进制文件(如果官方提供)。
4. 升级 uv
如果已安装,可以通过 pip 升级:
pip install --upgrade uv
5. 验证安装
运行以下命令,确认 uv 正常工作:
uv pip --help
如果输出帮助信息,说明安装成功。
6. 基本使用
uv 主要作为 pip 的替代品,常用命令:
# 安装包(替代 pip install)
uv pip install numpy pandas
# 批量安装(requirements.txt)
uv pip install -r requirements.txt
# 快速创建虚拟环境(需 Python 3.3+)
python -m venv .venv
source .venv/bin/activate# Linux/macOS
.\.venv\Scripts\activate# Windows
uv pip install <package># 在虚拟环境中使用
常见问题
- 权限问题:
如果遇到权限错误,尝试添加--user标志:
pip install --user uv
-
命令未找到:
确保~/.local/bin(Linux/macOS)或%APPDATA%\Python\Scripts(Windows)已加入PATH。 -
兼容性:
uv需要 Python 3.8+,建议使用最新版 Python。
为什么选择 uv?
- ⚡ 比
pip快 10-100 倍(依赖解析和并行下载)。 - 🔒 更可靠的依赖冲突处理(基于 Rust 的解析器)。
- 🛠️ 无缝替代
pip,兼容现有工作流(requirements.txt、pyproject.toml)。
如果需要更快的 Python 包管理,uv 是目前的最佳选择之一!

浙公网安备 33010602011771号