Generating by ChatGPT-4o
這是一個全新的系列文章，我會從頭開始，獨自搭建一套完整的 Django 後端系統。本篇將專注於專案初始化，包括資料夾結構設計、虛擬環境建立、資料庫串接，並最終啟動本地後端伺服器，完成第一步實作。
作為一名軟體工程師，良好的專案架構能讓開發過程更加清晰，不僅有助於初期的工作分配，也為未來的擴展與維護打下穩固的基礎。
首先是資料夾的初始架構，我們將 Django 作為後端來規劃，資料夾會這樣建立 :
web-project/
backend/
frontend/
- backend : 本系列的重點，專注於後端 (Django)
- frontend : 前端專案的位置，未來會另開系列介紹
在開始前，本篇會使用的工具如下：
- Python 3.13 版
- Visual Studio Code (IDE)
- Maria DB 11.7
- Git 2.49
IDE 和 DB 都是可以看個人習慣來做更換，並不影響後端 Django 的建立。準備好之後可以開始我們的第一步，以下都是使用 Windows 系統做說明，先進入後端資料夾 :
cd web-project/backend建立虛擬環境 :
python -m venv django-backend啟動虛擬環境 :
./django-backend/Scripts/activate此時可以看到你的指令列前面出現 (django-backend)，表示虛擬環境已經生效 :
啟動虛擬環境
啟動虛擬環境後，接下來在虛擬環境中安裝 Django :
pip install django檢查安裝 :
django-admin --version確認安裝完之後，使用 django-admin 工具來初始化專案 :
django-admin startproject config .*這邊注意最後的. ，表示直接把專案建立在 backend/ 資料夾之下，不用再多包一層
現在的backend/ 資料夾應該會長這樣 :
backend/
config/
__init__.py
settings.py
urls.py
wsgi.py
asgi.py
django-backend/
manage.py
接下來安裝資料庫，這邊可以選擇你常用的 :
pip install mariadb
pip install mysqlclient
修改 Django 的設定檔 config/settings.py ，找到 DATABASES 部分，改為你的 DB 設定 :
#補上資料庫設定，這邊用本地端IP表示，所以是127.0.0.1
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'backend',
'USER': 'root',
'PASSWORD': '你的密碼',
'HOST': '127.0.0.1',
'PORT': '3306',
}
}
與資料庫同步，初始化資料表 :
python manage.py migrate
可以看到資料庫已經建立好 Django 預設的資料表，例如 auth_user、django_migrations 等，代表同步成功 :
migrate
與資料庫同步
再來我們把專案加入 git 來管理，先退回到上層 :
cd ..
git init
*這邊完全是看個人習慣，因為前後端我經常會同步修改，所以我會放一起管理，也可以 backend 和 frontend 分開管理。
最外層新增 .gitignore ，把不需要版本控制的檔案加進去，目前就是 django-backend
# .gitignore
django-backend/
回到 backend/ 執行後端 server
cd backend
python manage.py runserver
預設路徑通常是 http://127.0.0.1:8000/，如果看到 Django 的歡迎畫面，恭喜你！代表已經成功了 :
Django 歡迎畫面
以上就是《我獨自 Django：開始我的 Django 專案》的第一篇介紹。下一篇《我獨自 Django：快速打造天氣 API 服務（上篇）》中，將帶大家從零開始，學習如何建立 App 並設計基本 API。
