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># 在虚拟环境中使用

常见问题

  1. 权限问题
    如果遇到权限错误,尝试添加 --user 标志:
pip install --user uv
  1. 命令未找到
    确保 ~/.local/bin(Linux/macOS)或 %APPDATA%\Python\Scripts(Windows)已加入 PATH

  2. 兼容性
    uv 需要 Python 3.8+,建议使用最新版 Python。


为什么选择 uv

  • pip 快 10-100 倍(依赖解析和并行下载)。
  • 🔒 更可靠的依赖冲突处理(基于 Rust 的解析器)。
  • 🛠️ 无缝替代 pip,兼容现有工作流(requirements.txtpyproject.toml)。

如果需要更快的 Python 包管理,uv 是目前的最佳选择之一!

posted @ 2025-07-13 23:02  258333  阅读(68)  评论(0)    收藏  举报