【后端】【UV】【Django】 `uv` 管理的项目中搭建一个 Django 项目

---

一步步搭建 Django 项目（适用于 uv + pyproject.toml 项目结构）

---

第 1 步：初始化一个 uv 项目（如果还没建好）

uv init django-project  # 创建项目，类似npm create vue

---

⚙️ 第 2 步：添加 Django 和 DRF（必须指定正确名字）

uv add django djangorestframework

注意：

• 不是 django-drf，正确的是：djangorestframework
• 避免将项目文件夹命名为 django（否则会报错 self-dependency）

---

️ 第 3 步：创建 Django 项目

django-admin startproject config .

config 是你的主项目目录名，可以自定义
. 表示在当前目录下创建（不嵌套）

成功后你将看到文件结构类似：

├── config/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── ...
├── manage.py
├── pyproject.toml

---

第 4 步：运行开发服务器验证一切正常

uv add  # 安装所有依赖（如你手动修改了 pyproject.toml）
python manage.py runserver

访问浏览器：
http://127.0.0.1:8000/
看到 Django 欢迎页就成功啦！

---

✅ 可选增强：添加 REST Framework 到 settings

打开 config/settings.py：

INSTALLED_APPS = [
    ...
    'rest_framework',
]

测试你的第一个 API，可以使用：

python manage.py startapp api

然后在 api/views.py 写个简单接口，再挂到 urls.py 上。

---

Bonus：生成 pyproject.toml 示例（完整）

[project]
name = "my-django-app"
version = "0.1.0"
dependencies = [
    "django>=5.2",
    "djangorestframework>=3.15",
]

[tool.uv]
virtualenv = ".venv"

---