uv 包管理工具使用教程

一、简介

uv 是一个基于 Rust 实现的超快 Python 包管理工具，旨在加速 Python 开发流程。它是 pip、pip-tools、virtualenv 和 venv 的现代替代品，支持更快的包解析、安装和虚拟环境创建。

主要特性包括：

极快的依赖解析与安装

自动创建和管理虚拟环境

与 pyproject.toml 和 requirements.txt 无缝集成

支持 PEP 582（无需虚拟环境）

适用于需要快速构建和部署 Python 项目的开发者和团队。

二、安装

1. 使用 pip 安装（推荐）

pip install uv

⚠️ 注意：建议使用 Python 3.8 及以上版本。

2. 使用 Homebrew（macOS）

brew install astral-sh/uv/uv

3. 使用官方预编译二进制
前往 GitHub 项目发布页下载对应平台的预编译文件：

https://github.com/astral-sh/uv/releases

下载后添加至系统 PATH 即可。

三、使用方法

1. 创建虚拟环境并安装依赖

uv pip install -r requirements.txt

或使用 pyproject.toml：

uv pip install

uv 会自动解析 pyproject.toml 并安装依赖。

2. 添加依赖包

uv pip install requests

3. 冻结依赖（生成 requirements.txt）

uv pip freeze > requirements.txt

4. 更新所有依赖

uv pip install -U -r requirements.txt

5. 启动虚拟环境 Shell

uv venv shell

6. 查看虚拟环境路径

uv venv path

7. 清理缓存

uv cache clean

四、注意事项

uv 默认启用了缓存机制，大幅提高了安装速度，但可能导致包版本不一致。推荐在 CI/CD 中禁用缓存或定期清理。

uv 当前还处于快速迭代阶段，建议关注 GitHub 发布页获取更新信息。

使用 pyproject.toml 时，建议配合 uv pip compile 生成锁定版本文件。

不同于 poetry 或 pipenv，uv 更注重性能而非项目结构管理。

五、参考链接

GitHub 项目主页: https://github.com/astral-sh/uv

官方文档: https://astral.sh/docs/uv