为什么要使用uv
uv 是一款由 Astral 开发的、用 Rust 编写的高性能 Python 包安装与项目管理工具。它旨在替代传统的 pip、virtualenv、pip-tools 等工具链,提供一体化、极速且现代化的 Python 工程化体验。
其核心优势包括:
- 极致性能
uv的包下载与解析速度可达pip或conda的 10 倍以上 ,这主要得益于其底层使用 Rust 语言实现 ,并充分利用多线程并行下载、缓存优化和高效的依赖解析算法。 - 一体化工具链
uv集成了虚拟环境创建(uv venv)、依赖安装(uv pip install)、依赖解析(支持requirements.txt和pyproject.toml)、包发布等常用功能,无需在多个工具间切换,简化了开发与部署流程。 - 自动依赖识别与管理
在项目中,uv能自动识别pyproject.toml、requirements.txt等依赖文件,智能解析项目所需的依赖项,并支持精确的版本锁定与冲突检测,确保环境的一致性与可复现性。 - 拥抱现代 Python 标准
uv原生支持pyproject.toml------ 这是 PEP 518/621 定义的现代 Python 项目配置标准。通过统一的配置文件,开发者可以更清晰、简洁地管理构建配置、依赖项和元数据。 - 轻量且可靠
尽管功能强大,uv本身非常轻量,单二进制文件即可运行,无外部依赖。同时,其依赖解析逻辑与pip高度兼容,确保了迁移的平滑性与结果的可靠性。
安装UV
使用命令
1.uv venv:在当前目录虚拟环境
2.激活方式:
Windows:.\.venv\Scripts\activate
Linux/MacOS:source .venv/bin/activate
3.uv add <包名>:当前虚拟环境添加包
# uv添加一个包
uv add requests
# uv添加多个包
uv add fastapi uvicorn numpy pandas
4.uv pip list:查看已安装的包
5.uv remove <包名>:移除某个包依赖
6.uv pip freeze > requirements.txt:导出依赖
# 导出当前环境的依赖
uv pip freeze > requirements.txt
# 导出生产环境依赖(排除开发依赖)
uv pip freeze --production > requirements.txt
7.uv sync:根据uv.lock和pyproject.toml安装依赖,类似于pip install -e .,但更高效
# 速度太慢的话可以在pyproject.toml中配置清华源
[tool.uv]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"
-
uv lock:生成/更新依赖锁,会将所有依赖包算出相应版本然后写入uv.lock文件
更新依赖
uv lock --upgrade
一般用不上的,用于开发python库:
9.uv build:将项目打包成 wheel/sdist ,别人在pip install 使用
- uv publish:将包发布到pypi上面,让全球开发者 pip install 你的库