在 Python 的世界里,长期以来我们依赖 pip 和 venv 进行依赖管理。然而,随着项目规模的扩大,这些传统方法在处理依赖冲突、安装速度和环境碎片化上逐渐显得力不从心。uv 的出现,不仅是一个工具的升级,更是 Python 工程化开发的一次效率革命。
1. 核心痛点:为什么传统的 pip + venv 显得笨重?
- 速度瓶颈:
pip安装依赖时,网络请求和依赖解析往往消耗大量时间,尤其是对于复杂项目。 - 管理分散:我们需要
venv创建环境,pip管理包,pip-tools处理锁文件,甚至还需要pyenv来切换 Python 版本。 - 磁盘浪费:每个项目创建一个独立的虚拟环境,相同的依赖包在磁盘上会被重复下载和存储多次,造成极大的空间浪费。
2. uv的核心优势对比
uv 是由 Astral 公司(Ruff 的创造者)开发的,使用 Rust 编写。它不仅仅是一个包安装器,更是一个统一的 Python 项目管理器。
| 特性 | 传统工具 (pip + venv + ) | uv |
|---|---|---|
| 性能 | 较慢 (Python 编写) | 极快 (Rust 编写,10-100x 提速) |
| 功能整合 | 分散 (需多个工具协作) | 一体化 (venv, pip, pyenv, 工具运行) |
| 依赖解析 | 基础且有时报错 | 先进且高效 (智能的全局锁文件机制) |
| 磁盘占用 | 高 (每个 venv 完整副本) | 极低 (利用全局缓存与硬链接) |
3. 实际应用场景对比
我们需要创建一个新项目并安装 requests库
(1)对于传统 pip + venv 方式
bash
# 1. 创建环境
python -m venv .venv
# 2. 激活 (不同系统命令不同)
source .venv/bin/activate
# 3.1. 安装单个包
pip install requests
# 3.2. 安装多个包
pip install requirements.txt
# 4. 冻结依赖
pip freeze > requirements.txt
(2)对于 uv 方式
csharp
# 直接安装并自动创建环境
uv add requests
# 直接运行安装多个依赖
uv pip install -e .
但是通过观察以上指令我们发现在指令中并没有给出需要安装哪些包或者这些包的路径信息,那uv是如何知道安装哪些包的呢?
(i)解析 :通过 pyproject.toml 识别哪些包
当你运行 uv pip install 时,如果没显式地指定文件,uv 会按照以下优先级在当前目录下扫描配置文件:
pyproject.toml(现代标准) :这是当前 Python 项目的核心配置文件。uv会读取其中的[project]部分(查看dependencies字段)来确定项目运行所需的库。setup.py/setup.cfg(传统标准) :如果你的项目较旧,uv依然支持通过这些文件解析依赖(即install_requires中的内容)。requirements.txt(默认备份) :如果你没有上述文件,uv会默认查找名为requirements.txt的文件。
(ii)锁定 :通过 uv.lock 记录安装包的具体版本
这是 uv 与传统 pip 最本质的区别。传统 pip 只是根据文本安装,而 uv 维护了一个锁定文件 (uv.lock) 。
uv会根据pyproject.toml的需求解析出所有依赖的精确版本,并将其写入uv.lock。- 下一次安装时,
uv直接读取uv.lock。它不再需要去远程服务器查找"应该安装哪个版本",因为它已经在锁定文件中记录得清清楚楚(包括包的哈希校验值)。
(iii)安装 :通过 uv.lock 实现瞬时安装。
通常在当前工程目录下运行 uv pip install -e .,表示在环境目录建立链接指向源码。
安装的具体效果如下图所示:

4. 总结
uv 的出现让 Python 的开发体验更接近于现代编程语言(如 Rust 的 cargo 或 Node.js 的 pnpm)。它并没有抛弃 Python 的标准,而是通过更高效的实现,让我们可以把时间花在代码逻辑上,而不是等待安装进度条。
如果你的项目中依然在手动维护复杂的 requirements.txt 或忍受缓慢的 pip 安装速度,尝试 uv 将会是提升开发幸福感的第一步。