UV实用教程

安装 uv

brew install uv

创建项目

初始化项目

uv init myproject

执行后会生成：

myproject/
├── pyproject.toml
├── .python-version
├── README.md
└── src/

创建虚拟环境

创建默认虚拟环境

uv venv

默认会创建：.venv/

指定 Python 版本

uv venv --python 3.12

指定虚拟环境目录

uv venv myenv

激活虚拟环境

source .venv/bin/activate

安装依赖

uv add requests

会自动：

• 安装依赖
• 更新 pyproject.toml
• 更新锁文件

⸻

安装指定版本

uv add "requests==2.32.0"

安装多个依赖

uv add flask sqlalchemy redis

安装开发依赖

uv add --dev pytest black ruff

删除依赖

uv remove requests

使用 Python

运行 Python

uv run python

运行脚本

uv run main.py

运行模块

uv run -m http.server

pyproject.toml 管理

uv 推荐使用：

[project]
name = "myproject"
version = "0.1.0"
dependencies = [
    "requests",
    "flask"
]

而不是传统requirements.txt

锁定依赖

生成锁文件

uv lock

会生成：uv.lock

同步依赖

uv sync

行为：

1. 检查 pyproject.toml
2. 检查 uv.lock
3. 如果 lock 文件过期：
   • 自动重新解析依赖
   • 自动更新 uv.lock
4. 同步虚拟环境

uv sync --locked

行为：

1. 检查 pyproject.toml
2. 检查 uv.lock
3. 如果 lock 已经过期：
   • 直接报错
   • 不自动更新
4. 如果 lock 有效：
   • 按 lock 安装

uv sync --frozen

行为：

• 完全信任现有 lock
• 不检查是否过期
• 不重新解析依赖
• 不更新 lock

Python 版本管理

安装 Python

uv python install 3.12

查看已安装 Python

uv python list

使用指定 Python

uv venv --python 3.12