Django 入門教學筆記 | 學習筆記

Posted by kdchang on 2023-07-01
javascript setTimeout for loop closure


前言

Django 是一個由 Python 編寫的高階 Web 框架，強調快速開發與簡潔設計。它提供完整的功能模組如 ORM、Admin 介面、Form 處理、URL 路由與認證系統，讓開發者能專注於商業邏輯而非重複造輪子。本文將帶你一步一步建立一個基本的 Django 應用程式，並說明其核心概念。

一、環境安裝

首先，請確保你已安裝好 Python（建議 3.8+）與 pip。以下是建立虛擬環境並安裝 Django 的方式：

python -m venv myenv
source myenv/bin/activate  # Windows 請使用 myenv\Scripts\activate
pip install django

確認安裝成功：

django-admin --version

二、建立 Django 專案

Django 使用專案（project）與應用程式（app）來組織程式碼。先建立一個新的專案：

django-admin startproject mysite
cd mysite

你會看到以下結構：

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

三、建立應用程式

應用程式是 Django 專案的功能模組。例如一個部落格、用戶系統或留言板就是一個 app。以下我們建立一個簡單的留言板：

python manage.py startapp guestbook

在 guestbook/ 資料夾中會看到以下結構：

guestbook/
    models.py
    views.py
    admin.py
    apps.py
    tests.py
    ...

接著，在 mysite/settings.py 中註冊這個 app：

INSTALLED_APPS = [
    ...
    'guestbook',
]

四、定義資料模型（Model）

編輯 guestbook/models.py，新增一個留言的資料模型：

from django.db import models

class Message(models.Model):
    name = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return f'{self.name} 說：{self.content[:20]}...'

建立資料表：

python manage.py makemigrations
python manage.py migrate

五、啟用後台管理介面

Django 提供強大的 admin 功能。先建立一個 superuser：

python manage.py createsuperuser

然後在 guestbook/admin.py 中註冊 model：

from django.contrib import admin
from .models import Message

admin.site.register(Message)

啟動伺服器並進入後台：

python manage.py runserver

前往瀏覽器開啟 http://127.0.0.1:8000/admin/，使用剛建立的帳號登入，即可操作資料。

六、建立 Views 與 Templates

接下來，我們撰寫一個簡單的留言列表與新增留言的畫面。

views.py

from django.shortcuts import render, redirect
from .models import Message

def message_list(request):
    if request.method == "POST":
        name = request.POST.get('name')
        content = request.POST.get('content')
        if name and content:
            Message.objects.create(name=name, content=content)
        return redirect('message_list')

    messages = Message.objects.order_by('-created_at')
    return render(request, 'guestbook/message_list.html', {'messages': messages})

templates

建立目錄 guestbook/templates/guestbook/message_list.html：

<!DOCTYPE html>
<html>
<head>
    <title>留言板</title>
</head>
<body>
    <h1>留言板</h1>
    <form method="post">
        {% csrf_token %}
        姓名：<input type="text" name="name"><br>
        留言：<br>
        <textarea name="content" rows="5" cols="40"></textarea><br>
        <input type="submit" value="送出">
    </form>
    <hr>
    {% for msg in messages %}
        <p><strong>{{ msg.name }}</strong> 說：</p>
        <p>{{ msg.content }}</p>
        <p><small>{{ msg.created_at }}</small></p>
        <hr>
    {% endfor %}
</body>
</html>

七、設定 URL 路由

在 guestbook/ 建立 urls.py：

from django.urls import path
from . import views

urlpatterns = [
    path('', views.message_list, name='message_list'),
]

然後到 mysite/urls.py 中加入：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('guestbook.urls')),
]

八、啟動開發伺服器

python manage.py runserver

在瀏覽器開啟 http://127.0.0.1:8000/，你將看到留言板畫面，並能提交留言。

總結

Django 是功能非常齊全且具可擴展性的 Web 框架，初學者可從資料模型、後台管理、表單處理與模板引擎著手。本文僅為入門教學，未來更多進階功能如使用 class-based views、form 類別、自訂 middleware、部署到雲端等，規劃在之後的教學筆記進行介紹。


歡迎分享按讚給予支持和鼓勵！

KD Chang（張凱迪）

Related Posts

Comments