Python包管理工具之uv的使用详细指南_Python

uv 是一个新兴的 python 包管理工具，它旨在提供比 pip 和 poetry 更快、更现代的依赖管理体验。uv 由 charles murphy 开发，基于 rust 构建，具有极高的性能和兼容性，支持标准的 requirements.txt 文件以及 pyproject.toml 中的依赖声明。

一、uv 的特点

特点	描述
极速安装	使用 rust 编写，依赖解析速度远超 pip 和 poetry
安全性	支持签名包验证（pep 458）
支持多种格式	兼容 wheels、sdists、editable installs
虚拟环境管理	自动创建和管理虚拟环境
依赖锁定	自动生成 uv.lock 文件确保可重复构建
多种配置方式	支持 requirements.txt、pyproject.toml 等
跨平台	支持 macos、linux、windows

二、安装 uv

使用官方推荐方式（适用于大多数用户）

# macos / linux 用户使用以下命令安装
curl -ls https://install.uv.rs | sh

安装后会将 uv 添加到你的 path 中。

使用 pip 安装（python >= 3.8）

pip install uv

使用 conda/mamba 安装（conda 用户）

conda install -c conda-forge uv

三、基本使用方法

1. 初始化项目并创建虚拟环境

mkdir myproject && cd myproject
uv venv
source .venv/bin/activate  # windows: .venv\scripts\activate

uv venv 会自动在当前目录下创建 .venv 虚拟环境。

2. 安装依赖

使用 requirements.txt

uv pip install -r requirements.txt

安装单个包

uv pip install requests

安装开发依赖

uv pip install pytest --dev

注意：目前 --dev 仅在使用 pyproject.toml 时有效。

3. 生成依赖文件

uv pip freeze > requirements.txt

或使用：

uv lock

这会生成 uv.lock 文件，用于精确锁定依赖版本。

4. 使用 pyproject.toml 管理依赖

你可以创建一个 pyproject.toml 来定义项目依赖：

[project]
name = "myapp"
version = "0.1.0"
dependencies = [
    "requests",
    "fastapi>=0.68.0,<0.70.0"
]

[build-system]
requires = ["setuptools>=42"]
build-backend = "setuptools.build_meta"

然后执行：

uv sync

这会根据 pyproject.toml 安装依赖，并自动生成 uv.lock 文件。

5. 升级依赖

uv pip upgrade requests

升级所有依赖：

uv pip upgrade --all

6. 删除依赖

uv pip uninstall requests

四、高级功能

1. 可重复构建（reproducibility）

通过 uv.lock 文件可以保证不同机器上的依赖完全一致：

uv sync

该命令会严格按照 uv.lock 中的版本安装依赖。

2. 支持编辑模式（editable installs）

uv pip install -e .

适合本地开发调试。

3. 镜像源设置（mirror support）

uv pip install requests --index-url https://pypi.tuna.tsinghua.edu.cn/simple

支持国内镜像加速安装。

五、uv vs pip vs poetry 对比

功能	uv	pip	poetry
依赖解析速度	⚡⚡⚡	⚡	⚡⚡
锁机制	✅ (uv.lock)	❌	✅ (poetry.lock)
虚拟环境管理	✅	❌（需配合 venv）	✅
编辑模式支持	✅	✅	✅
依赖冲突检测	✅	❌	✅
打包发布支持	❌	❌	✅
镜像源支持	✅	✅	✅
安装方式	独立二进制、pip、conda	pip	pip、standalone installer

六、适用场景推荐

场景	推荐
快速脚本、小项目	✅ uv + requirements.txt
web 后端开发	✅ uv + pyproject.toml
数据科学、ai 模型训练	✅ uv + conda（如 miniforge）
需要打包发布的库	✅ poetry
需要多 python 版本切换	✅ pyenv + uv

七、示例流程（从零开始）

# 创建项目目录
mkdir hello-uv && cd hello-uv

# 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate

# 安装依赖
uv pip install requests

# 查看已安装包
uv pip list

# 冻结依赖
uv pip freeze > requirements.txt

# 生成锁文件
uv lock

# 后续只需运行：
uv sync

以上就是python包管理工具之uv的使用详细指南的详细内容，更多关于python uv包管理的资料请关注代码网其它相关文章！