背景痛点：毕设里那些“磨人”的低效瞬间
做毕设最怕什么？不是不会写代码，而是把时间都耗在“重复劳动”上。我去年带 5 组学弟，他们几乎踩了同一串坑：
- 每建一个新模型就把
id、create_time、update_time手写一遍，迁移脚本满天飞，字段一改就冲突。 - 本地 SQLite，服务器 MySQL，字段类型对不上，一上线就 500。
- 手动
python manage.py collectstatic，CSS 经常 404，答辩现场翻车。 - 没有单元测试，改一行代码全靠“刷新页面”——肉眼 CI/CD。
结果真正花在业务逻辑上的时间不到 30%，大量精力被“配环境、调配置、清缓存”吃掉。毕设周期本来就短，效率一低，论文和 PPT 都只能连夜冲刺，质量可想而知。
技术选型：为什么最后选了 Django
在确定选题后，我们曾把 Flask、FastAPI 和 Django 拉到一起 PK：
- Flask：灵活，但蓝图、ORM、后台都要自己拼，对“只想毕业”的同学来说，自由≈负担。
- FastAPI：异步性能亮眼，可毕业答辩评委更关心“有没有管理后台”，FastAPI 没有官方 admin，接口文档再好看也得额外写前端。
- Django：自带 ORM、Admin、Auth、迁移、测试客户端，一条龙。对“快速出活儿”极度友好；插件生态成熟，GitHub 上可抄现成模块多。
一句话：Django 的“全家桶”属性，能把常见毕设需求（用户权限、内容管理、分页搜索、文件上传）用最小代码量串起来，效率分直接拉满。
项目结构标准化：先搭好“脚手架”
我给自己定的规矩：任何新项目，30 秒内目录必须长这样：
graduation_project/ ├─ apps/ # 所有业务应用 │ ├─ core/ # 抽象基类、工具函数 │ ├─ users/ # 用户系统 │ └─ thesis/ # 具体业务（论文上传、评分...） ├─ config/ # 配置分层 │ ├─ settings/ │ │ ├─ base.py │ │ ├─ local.py │ │ └─ prod.py │ └─ urls.py ├─ requirements/ │ ├─ base.txt │ ├─ local.txt │ └─ prod.txt ├─ .envs/ # 环境变量模板 ├─ scripts/ # 一键启动、备份、还原 └─ docker/ # Dockerfile & compose好处：
- 应用解耦，毕设后期加“通知模块”直接
python manage.py startapp notice，不碰旧代码。 - 配置按环境拆分，把
DEBUG/SECRET_KEY/数据库全部抽离到.env，本地与服务器零冲突。 - 多人协作时，拉代码就能跑，不用口头传“你还得改这改那”。
配置管理：把“踩坑开关”收进 .env
settings/base.py 只放默认值，其余全读环境变量：
# config/settings/base.py import environ, os env = environ.Env() environ.Env.read_env(env_file=os.path.join(BASE_DIR, '.envs/.local')) SECRET_KEY = env('DJANGO_SECRET_KEY') DEBUG = env.bool('DJANGO_DEBUG', default=False) ALLOWED_HOSTS = env.list('DJANGO_ALLOWED_HOSTS', default=[]) DATABASES = { 'default': env.db_url('DATABASE_URL') # 一行搞定 mysql/postgres }模板.envs/.local提交到仓库时留空值，.envs/.prod在服务器由 CI 注入，再也不怕把DEBUG=True推到线上。
模型抽象：一次定义，终身复用
所有业务模型都继承同一基类，省去重复字段：
# apps/core/models.py from django.db import models from django.utils import timezone class BaseModel(models.Model): """自带主键、时间戳、软删除标记""" id = models.BigAutoField(primary_key=True) create_time = models.DateTimeField(default=timezone.now, db_index=True) update_time = models.DateTimeField(auto_now=True, db_index=True) is_deleted = models.BooleanField(default=False, db_index=True) class Meta: abstract = True之后写业务模型：
class Thesis(BaseModel): title = models.CharField(max_length=120) file = models.FileField(upload_to='thesis/%Y/%m/') owner = models.ForeignKey('users.User', on_delete=models.CASCADE)迁移脚本行数直接砍半，后期加字段只改一处，爽。
Admin 后台增强：让评委一眼看懂
Django Admin 默认就能跑，但稍加定制就能当“演示系统”：
# apps/thesis/admin.py from django.contrib import admin from .models import Thesis @admin.register(Thesis) class ThesisAdmin(admin.ModelAdmin): list_display = ('id', 'title', 'owner', 'create_time', 'status') list_filter = ('status', 'create_time') search_fields = ('title', 'owner__username') date_hierarchy = 'create_time'再给模型加__str__，后台就能中文搜索，答辩演示时老师一看就会用，比临时写 Vue 省事太多。
异步任务：Celery 让“导出 Excel”不卡页面
毕设里常见“一键导出全部成绩”需求，数据一多就超时。用 Celery 把任务丢到后台：
# apps/thesis/tasks.py from celery import shared_task from django.core.mail import send_mail @shared_task def export_scores(user_email): # 伪代码：生成 Excel 并发送附件 ... send_mail('成绩已导出', '请查收附件', None, [user_email])视图里直接：
export_scores.delay(request.user.email)前端轮询或 WebSocket 通知完成，页面再也不转菊花。
代码示例：settings 分层 + 异步任务完整片段
# config/settings/local.py from .base import * DEBUG = True CELERY_BROKER_URL = 'redis://127.0.0.1:6379/0' CELERY_RESULT_BACKEND = 'redis://127.0.0.1:6379/0' # config/settings/prod.py from .base import * DEBUG = False ALLOWED_HOSTS = ['your.domain.com'] CELERY_BROKER_URL = env('REDIS_URL')Docker-Compose 一键启环境：
# docker-compose.local.yml version: "3.8" services: web: build: . command: python manage.py runserver 0.0.0.0:8000 volumes: - .:/app ports: - "8000:8000" env_file: - .envs/.local redis: image: redis:7-alpine celery: build: . command: celery -A config worker -l info volumes: - .:/app depends_on: - redis本地docker compose -f docker-compose.local.yml up即可同时跑 Web + 异步 worker，零环境差异。
性能与安全：默认就“带盾”
- ORM 默认开启 SQL 注入防护；模板自动转义，XSS 概率大降。
- 开
CSRF_USE_SESSIONS=True+CSRF_COOKIE_HTTPONLY=True，毕业项目也敢开公网。 - 查询优化：用
select_related/prefetch_related把 N+1 扼杀在答辩前：
Thesis.objects.select_related('owner').prefetch_related('reviewers')- 分页必加，默认 20 条；导出功能走异步，避免一次性拉爆内存。
生产环境避坑清单
- DEBUG 千万别 True，上线前用
django-admin-outbox这类包本地测邮件，防止外网 SMTP 泄露。 - 静态文件
DEBUG=False后必须python manage.py collectstatic，再配 Nginx：
location /static/ { alias /app/staticfiles/; }- 迁移冲突：多人改模型，先在本地
python manage.py makemigrations --merge，再提交；CI 里加--check防止漏迁。 - 数据库备份：cron +
pg_dump或mysqldump，每晚同步到对象存储，毕业答辩前硬盘崩了也能 10 分钟回滚。
把毕设做成“能秀”的工程作品
效率提升不是目的，而是给自己留出时间做“亮点”：
- 用 GitHub Actions 跑通 CI：push 即测、PR 即审，Commit Graph 一片绿，评委直观感受“专业”。
- 写一份部署文档，把
docker-compose、env 模板、ER 图放进 repo，面试时直接甩链接，比简历里写“熟悉 Django”更有说服力。 - 录屏演示：从代码提交到自动部署上线 5 分钟全流程，现场播放，老师通常不会再追问“你这个项目到底真不真”。
动手把现在的项目目录拆一拆，把配置抽化、模型抽象、Admin 增强、Celery 集成这几步跑通，你会明显感到“写业务逻辑”的时间变多，“配环境”的烦躁变少。剩下的精力，不妨思考：如果下个月就要给面试官展示，哪些数字、图表、自动化流程能让对方 30 秒内 Get 到亮点？答案往往就藏在“效率提升”省出的那 50% 时间里。祝你毕设一遍过，也祝你把这份作品真正变成能拿出去说话的“工程名片”。
