1. 项目背景与核心需求
作为Python生态中最流行的Web框架之一，Django以其"全栈式"设计理念深受开发者喜爱。这个作业项目看似简单，实则包含了Web开发的核心要素：模型定义、视图处理、模板渲染和路由配置。对于初学者而言，完成第一个Django作业就像搭建乐高积木的基础模块 - 虽然每个零件都很简单，但组合方式决定了最终成品的稳固性。
我在指导团队新人时发现，90%的Django初学者会在以下环节卡壳：
- 虚拟环境配置（总有人直接全局安装包）
- 模型字段类型选择（CharField到底设多长？）
- 视图函数与模板的传参方式（context字典的魔法）
- 静态文件处理（为什么CSS死活不加载？）
这个作业将用最小可行案例(MVP)演示如何避开这些坑。我们以"学生信息管理系统"为例，包含学生信息的增删改查(CRUD)功能，代码量控制在200行以内但涵盖所有核心概念。
2. 环境准备与项目初始化
2.1 开发环境配置
推荐使用Python 3.8+版本，这是Django 4.x的黄金搭档。千万别用Python 3.12这种太新的版本 - 我上个月就遇到psycopg2适配问题折腾了半天。
bash复制# 创建虚拟环境（Windows用py -m venv）
python3 -m venv django_env
source django_env/bin/activate # Linux/Mac
django_env\Scripts\activate # Windows
# 安装依赖时指定版本更稳妥
pip install django==4.2.6
踩坑提示：有些教程会建议用
django-admin startproject创建项目，但对于作业类小项目，我更喜欢用manage.py startapp直接创建应用，减少目录层级带来的认知负担。
2.2 项目结构设计
非标准但更清晰的小项目结构：
code复制student_manager/
├── manage.py
├── student_app/
│ ├── models.py
│ ├── views.py
│ ├── templates/
│ │ └── student_app/
│ │ ├── list.html
│ │ └── form.html
│ └── urls.py
└── student_system/
├── settings.py
└── urls.py
这种扁平化结构的好处是：
- 模板文件放在各自app目录下，避免命名冲突
- 每个app有自己的urls.py，路由解耦
- 适合作业类小项目快速迭代
3. 核心功能实现
3.1 模型设计实战
在models.py中定义学生模型时，字段类型选择直接影响后续表单验证：
python复制from django.db import models
class Student(models.Model):
name = models.CharField(max_length=50) # 中文姓名一般3个字+复姓最多5字
student_id = models.CharField(max_length=10, unique=True)
AGE_CHOICES = [(i, str(i)) for i in range(15, 26)]
age = models.IntegerField(choices=AGE_CHOICES)
is_active = models.BooleanField(default=True)
def __str__(self):
return f"{self.student_id}-{self.name}"
字段设计经验：
CharField必设max_length，数据库会据此优化存储- 年龄用choices限定范围比单纯IntegerField更安全
__str__方法要返回唯一性高的组合，方便admin后台识别
3.2 视图逻辑编写
使用基于函数的视图(FBV)更适合初学者理解请求-响应流程：
python复制from django.shortcuts import render, redirect
from .models import Student
from .forms import StudentForm
def student_list(request):
students = Student.objects.filter(is_active=True)
return render(request, 'student_app/list.html', {'students': students})
def student_create(request):
if request.method == 'POST':
form = StudentForm(request.POST)
if form.is_valid():
form.save()
return redirect('student_list')
else:
form = StudentForm()
return render(request, 'student_app/form.html', {'form': form})
关键技巧：在开发阶段可以加
print(request.POST)调试表单提交数据，比用断点更直观
3.3 模板渲染要点
list.html模板中使用Bootstrap5快速美化：
html复制{% extends "student_app/base.html" %}
{% block content %}
<table class="table table-hover">
<thead>
<tr>
<th>学号</th>
<th>姓名</th>
<th>年龄</th>
</tr>
</thead>
<tbody>
{% for student in students %}
<tr>
<td>{{ student.student_id }}</td>
<td>{{ student.name }}</td>
<td>{{ student.get_age_display }}</td> <!-- 显示choices的可读值 -->
</tr>
{% endfor %}
</tbody>
</table>
{% endblock %}
模板开发三大坑：
- 忘记
{% load static %}导致静态文件404 - 变量名与views.py中context字典key不匹配
- 继承模板时block名称拼写错误
4. 调试与部署技巧
4.1 开发服务器问题排查
当出现"Page not found"错误时，按这个顺序检查：
python manage.py show_urls确认路由是否注册- 浏览器开发者工具看请求是否发出(200/404)
- 视图函数是否正确定义了request参数
- 模板文件是否放在正确的
templates/app_name/目录
4.2 数据库迁移问题
遇到迁移失败时：
bash复制# 回退到上一个迁移版本
python manage.py migrate student_app 0001_initial
# 删除问题迁移文件后重建
python manage.py makemigrations --empty student_app
4.3 静态文件配置
确保settings.py包含：
python复制STATIC_URL = 'static/'
STATICFILES_DIRS = [BASE_DIR / "static"] # 开发环境专用
在模板中正确引用：
html复制<link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
5. 作业扩展建议
如果想拿高分，可以考虑：
- 增加照片上传功能（需配置MEDIA_ROOT）
- 实现分页器（Django自带Paginator类）
- 添加简单的权限控制（@login_required装饰器）
- 用Class-based View重写部分逻辑
我带的实习生曾用Django REST Framework给这个作业加了API接口，虽然超出要求但展示了学习主动性 - 这个小创新让他拿到了A+。记住：Django就像乐高，基础组件掌握后，创造什么取决于你的想象力。