---

🚀 一步步搭建 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"

---