使用 uv 工具从 pyproject.toml 和 uv.lock 快速安装 Python 依赖
一、背景说明
Python 社区正在逐步向 pyproject.toml 统一依赖与构建配置文件的方向发展。uv 是由 Astral 开发的全新依赖解析和安装工具,支持:
- 超快的解析与安装(比 pip 快 8-10 倍)
- 原生支持
pyproject.toml和uv.lock - 不依赖 Conda,采用轻量级虚拟环境管理
二、前提条件
确保你已经安装了 uv:
pip install uv # 或者使用 Homebrew(macOS) brew install astral-sh/tap/uv
⚠️ 注意:
uv与conda不兼容,因此需要使用venv虚拟环境或其他轻量方式。
三、项目结构
假设你的项目结构如下:
your-project/
├── pyproject.toml
└── uv.lock
pyproject.toml 用于定义依赖,uv.lock 是锁定具体包版本的文件。
四、创建并激活虚拟环境
uv venv # 会在项目根目录生成 .venv 虚拟环境
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
如果你已经有自己的 venv,也可以跳过这一步。
五、从 uv.lock 安装依赖
使用如下命令即可安装所有依赖:
uv sync
uv 会自动读取 uv.lock,并根据其中锁定的版本下载和安装依赖,确保完全一致的环境。
六、常用命令总结
| 命令 | 说明 |
|---|---|
uv sync | 安装所有锁定依赖 |
uv pip install <pkg> | 添加新依赖并更新 pyproject.toml |
uv pip freeze > uv.lock | 生成新的锁定文件 |
uv venv | 创建虚拟环境 |


