94 lines
1.5 KiB
Markdown
94 lines
1.5 KiB
Markdown
# 使用 uv 管理 Python 依赖
|
||
|
||
本项目已迁移到使用 [uv](https://github.com/astral-sh/uv) 作为 Python 依赖管理器。
|
||
|
||
## 快速开始
|
||
|
||
### 安装 uv
|
||
|
||
```bash
|
||
# macOS/Linux
|
||
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||
|
||
# 或使用 Homebrew
|
||
brew install uv
|
||
```
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
cd backend
|
||
uv sync
|
||
```
|
||
|
||
这会自动创建虚拟环境并安装所有依赖。
|
||
|
||
### 运行项目
|
||
|
||
```bash
|
||
# 激活虚拟环境（uv 会自动管理）
|
||
uv run uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
||
|
||
# 或使用 uv 直接运行
|
||
uv run python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
||
```
|
||
|
||
### 数据库迁移
|
||
|
||
```bash
|
||
uv run alembic upgrade head
|
||
```
|
||
|
||
### 添加新依赖
|
||
|
||
```bash
|
||
# 添加依赖
|
||
uv add package-name
|
||
|
||
# 添加开发依赖
|
||
uv add --dev package-name
|
||
```
|
||
|
||
### 更新依赖
|
||
|
||
```bash
|
||
uv sync --upgrade
|
||
```
|
||
|
||
### 其他常用命令
|
||
|
||
```bash
|
||
# 查看已安装的包
|
||
uv pip list
|
||
|
||
# 运行 Python 脚本
|
||
uv run python script.py
|
||
|
||
# 运行 Alembic 命令
|
||
uv run alembic <command>
|
||
```
|
||
|
||
## 从 pip/venv 迁移
|
||
|
||
如果你之前使用 pip 和 venv：
|
||
|
||
1. 删除旧的虚拟环境（可选）：
|
||
```bash
|
||
rm -rf venv
|
||
```
|
||
|
||
2. 使用 uv 同步依赖：
|
||
```bash
|
||
uv sync
|
||
```
|
||
|
||
3. 之后使用 `uv run` 运行命令，或激活 uv 创建的虚拟环境。
|
||
|
||
## 优势
|
||
|
||
- **速度快**：比 pip 快 10-100 倍
|
||
- **可复现**：自动生成锁文件
|
||
- **简单**：一个命令管理所有依赖
|
||
- **兼容**：完全兼容 pip 和 requirements.txt
|
||
|