83 lines
1.7 KiB
Markdown
83 lines
1.7 KiB
Markdown
# 迁移到 uv 依赖管理器
|
||
|
||
## ✅ 已完成的工作
|
||
|
||
1. **初始化 uv 项目**
|
||
- 创建了 `pyproject.toml` 配置文件
|
||
- 所有依赖已迁移到 `pyproject.toml`
|
||
|
||
2. **依赖管理**
|
||
- 使用 `uv sync` 安装所有依赖
|
||
- 创建了 `.venv` 虚拟环境（uv 自动管理）
|
||
- 生成了 `requirements-lock.txt` 锁定文件
|
||
|
||
3. **工具和脚本**
|
||
- 创建了 `start.sh` 启动脚本
|
||
- 创建了 `README_UV.md` 使用文档
|
||
|
||
## 📝 使用方式
|
||
|
||
### 启动服务
|
||
|
||
```bash
|
||
cd backend
|
||
./start.sh
|
||
```
|
||
|
||
或手动启动：
|
||
|
||
```bash
|
||
cd backend
|
||
uv run uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
||
```
|
||
|
||
### 数据库迁移
|
||
|
||
```bash
|
||
cd backend
|
||
uv run alembic upgrade head
|
||
```
|
||
|
||
### 添加新依赖
|
||
|
||
```bash
|
||
cd backend
|
||
uv add package-name
|
||
```
|
||
|
||
## 🔄 从旧环境迁移
|
||
|
||
如果你之前使用 `venv` 和 `pip`：
|
||
|
||
1. **删除旧虚拟环境**（可选）：
|
||
```bash
|
||
rm -rf venv
|
||
```
|
||
|
||
2. **使用 uv 同步**：
|
||
```bash
|
||
uv sync
|
||
```
|
||
|
||
3. **之后使用 `uv run` 运行所有命令**
|
||
|
||
## 📦 依赖文件说明
|
||
|
||
- `pyproject.toml` - 项目配置和依赖声明（主要文件）
|
||
- `requirements.txt` - 保留用于兼容性，但建议使用 `pyproject.toml`
|
||
- `requirements-lock.txt` - 自动生成的锁定文件（确保可复现）
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
- uv 创建的虚拟环境在 `.venv/` 目录（不是 `venv/`）
|
||
- 使用 `uv run` 运行命令会自动使用正确的虚拟环境
|
||
- 也可以手动激活：`source .venv/bin/activate`
|
||
|
||
## 🎯 优势
|
||
|
||
- ⚡ **速度快**：比 pip 快 10-100 倍
|
||
- 🔒 **可复现**：自动生成锁定文件
|
||
- 🎯 **简单**：一个命令管理所有依赖
|
||
- 🔄 **兼容**：完全兼容 pip 和 requirements.txt
|
||
|