萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Django 實作 Simple-Todo 教學:從建立專案到部署的完整流程

專案簡介

Simple-Todo 是跨框架教學專案 (web.py/Uliweb/Bottle/Flask/Django),實作基本待辦事項 CRUD。本文記錄 Django 版本完整建立過程。

環境需求

  • Python 3.8+
  • Django 4.2+ (LTS)

步驟 1:建立專案與 App


django-admin startproject simple_todo_site
cd simple_todo_site
python manage.py startapp simpletodo

步驟 2:配置 settings.py


# simple_todo_site/settings.py
import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

SECRET_KEY = 'dev-secret-key-change-in-production'
DEBUG = True
ALLOWED_HOSTS = ['*']

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'simpletodo',  # 關鍵:註冊 app
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'simple_todo_site.urls'

TEMPLATES = [{
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'DIRS': [BASE_DIR / 'templates'],  # 專案級模板目錄
    'APP_DIRS': True,
    'OPTIONS': {
        'context_processors': [
            'django.template.context_processors.debug',
            'django.template.context_processors.request',
            'django.contrib.auth.context_processors.auth',
            'django.contrib.messages.context_processors.messages',
        ],
    },
}]

# 資料庫 (開發用 SQLite)
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

# 靜態檔案
STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / 'static']
STATIC_ROOT = BASE_DIR / 'staticfiles'

# 媒體檔案
MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / 'media'

步驟 3:定義模型 (simpletodo/models.py)


from django.db import models
from django.contrib import admin

class Todo(models.Model):
    title = models.CharField('標題', max_length=255)
    finished = models.BooleanField('完成', default=False)
    created_at = models.DateTimeField('建立時間', auto_now_add=True)
    updated_at = models.DateTimeField('更新時間', auto_now=True)
    
    class Meta:
        ordering = ['-created_at']
        verbose_name = '待辦事項'
        verbose_name_plural = '待辦事項'
    
    def __str__(self):
        return self.title

# Admin 註冊
@admin.register(Todo)
class TodoAdmin(admin.ModelAdmin):
    list_display = ('title', 'finished', 'created_at')
    list_filter = ('finished', 'created_at')
    search_fields = ('title',)
    list_editable = ('finished',)

步驟 4:建立資料庫與啟動


python manage.py makemigrations
python manage.py migrate
python manage.py runserver
# 瀏覽器開啟 https://127.0.0.1:8000/
# Admin: https://127.0.0.1:8000/admin/

步驟 5:實作 Views 與 Templates

simpletodo/views.py


from django.shortcuts import render, redirect, get_object_or_404
from django.views.decorators.http import require_http_methods
from .models import Todo

def todo_list(request):
    todos = Todo.objects.all()
    return render(request, 'simpletodo/list.html', {'todos': todos})

@require_http_methods(["POST"])
def todo_add(request):
    title = request.POST.get('title', '').strip()
    if title:
        Todo.objects.create(title=title)
    return redirect('todo_list')

@require_http_methods(["POST"])
def todo_toggle(request, pk):
    todo = get_object_or_404(Todo, pk=pk)
    todo.finished = not todo.finished
    todo.save()
    return redirect('todo_list')

@require_http_methods(["POST"])
def todo_delete(request, pk):
    todo = get_object_or_404(Todo, pk=pk)
    todo.delete()
    return redirect('todo_list')

templates/simpletodo/list.html


{% load static %}



    Simple Todo
    


    

📝 Simple Todo

{% csrf_token %}
    {% for todo in todos %}
  • {{ todo.title }} {{ todo.created_at|date:"M d, H:i" }}
  • {% empty %}
  • 暫無待辦事項
  • {% endfor %}

步驟 6:配置 URL 路由


# simple_todo_site/urls.py
from django.contrib import admin
from django.urls import path
from simpletodo import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.todo_list, name='todo_list'),
    path('add/', views.todo_add, name='todo_add'),
    path('toggle//', views.todo_toggle, name='todo_toggle'),
    path('delete//', views.todo_delete, name='todo_delete'),
]

步驟 7:靜態檔案與部署準備


# 收集靜態檔案
python manage.py collectstatic

# 建立超級使用者
python manage.py createsuperuser

# 生產環境建議
# - 使用 PostgreSQL
# - 設定 DEBUG=False, ALLOWED_HOSTS
# - 使用 Gunicorn + Nginx
# - 配置 HTTPS、靜態檔案 CDN

擴展練習建議

  • 加入使用者認證:@login_required 裝飾器,每用戶獨立待辦
  • 加入截止日期、優先級、分類標籤
  • 使用 HTMX/Alpine.js 實現無刷新編輯、拖曳排序
  • 撰寫單元測試:python manage.py test simpletodo
  • 部署至 Render/Railway/Heroku 免費方案

完成此專案可掌握 Django MVT 架構、ORM、Admin、模板、表單、靜態檔案等核心開發流程。

copyright © 萬盛學電腦網 all rights reserved