这标题一看就是最常见的毕业设计款式——基于Django的蛋糕购物商城网站的设计与实现。它听起来简单但实际上是Django全栈项目里相当典型的一套组合要做用户体系、商品展示、购物车、订单流转还要有一个后台管理界面来维护商品库存和订单状态。对于第一次完整做Web项目的同学来说这个题目的难度刚好卡在“能做完”和“有东西可写”之间不会像纯CRUD那样单薄又比分布式电商那种大型架构容易驾驭得多。我见过不少人在这个题目上栽跟头要么是照着网上的商城教程改了改就交差结果答辩老师一问购物车是怎么存的就答不上来要么是选型太花哨Django REST framework加Vue加Redis最后前端崩溃、面试效果还很差。实际上做一个能稳定运行、逻辑清晰、论文有内容可写的蛋糕商城老老实实用Django模板系统加Bootstrap加上SQLite或MySQL把几个核心功能做扎实远比堆技术栈更重要。这篇文章我会按我自己的实操习惯把这套项目从需求拆解、技术选型、核心功能实现、常见调试问题到扩展定制全部过一遍。里面所有内容都是基于我自己做类似全栈课程项目时的经验你可以直接把它当作一份技术复盘来参考。1. 项目整体拆解与需求分析1.1 标题背后到底考了哪些能力Django、蛋糕购物商城、设计与实现这三个关键词组合起来考察的是四层能力。第一层是Python后端基本功你要能用Django处理路由、视图、模型和表单第二层是前端基础页面要能看得过去不能是光秃秃的列表第三层是业务逻辑理解购物车、订单状态、库存扣减这些关系要捋清楚第四层是项目文档能力因为毕设往往还要配说明文档代码写得再漂亮说不清设计思路也会吃亏。也就是说这个题目并不是让你做一个“能跑就行”的玩具而是要求你完整走一遍软件开发的主线流程需求分析、数据库建模、接口设计、前端页面、测试调试、部署演示。1.2 核心功能模块怎么划分蛋糕商城的用户角色至少要有两类普通用户和管理员。普通用户关心的是注册登录、浏览蛋糕列表、查看详情、加入购物车、下单支付模拟和查看自己的订单管理员关心的是商品分类管理、蛋糕上下架、库存数量调整、订单发货状态处理。从模块划分上我建议分成这几个部分用户模块、商品模块、购物车模块、订单模块、后台管理模块。每个模块在Django里对应一个app不要把所有逻辑都塞到一个views.py里。这样既能让你答辩的时候说清楚结构也能让代码后期维护变得容易。1.3 为什么这类题目必须控制范围很多同学一开始会想把支付、优惠券、积分、评论、秒杀全部做进去。别这么做。毕设的重点不是功能多而是功能完整、逻辑自洽、有实现深度。支付接口在实际项目里要对接平台个人项目很难真的调用所以绝大多数Django商城毕设的支付都是“模拟支付”也就是提交订单后跳转到一个支付成功页面同时把订单状态改成“已付款”。我见过最聪明的做法是额外做一个“满减优惠”或者“积分抵扣”的小逻辑写在订单结算里一旦答辩老师问“你项目里有什么亮点”你就可以拿出这个自己实现的小算法来讲解。它不难但能给论文增加不少素材。2. 技术选型与架构设计思路2.1 框架版本与工具链的选择Django当前主流版本是4.x但很多网上的教程还在用3.x写。我个人建议直接用Django 4.2 LTS它是长期支持版本功能稳定而且Python 3.10/3.11能完美兼容。数据库方面开发阶段用SQLite就够了部署演示时可以再切换到MySQL不过如果你们的课程设计默认要求MySQL那从一开始就用MySQL也是可以的Django的ORM切换成本很低。前端不用框架直接用Django模板语言配合Bootstrap 5。你不需要会Vue也不需要会React只要能在模板里写{% for %}和{{ 变量 }}再套一个Bootswatch的主题页面整体观感就能达到课程设计优秀的水准。2.2 数据库模型设计的核心关系蛋糕商城的数据关系其实不复杂关键就几条一个分类对应多个蛋糕一个用户对应多个订单一个订单对应多个订单商品。所以数据库至少要有这些表用户表可以用Django自带的、分类表、蛋糕表、订单表、订单项表还可能要购物车表或者用Session存购物车。这里有一个最常见的坑很多人会把购物车建成数据库模型每个用户存一个购物车记录。这样做不是不行但会牵扯到用户是否登录、Cookie和Session同步等问题。我更推荐的做法是未登录用户把购物车存在Session里登录后把Session中的购物车数据合并到数据库订单流程中。这样逻辑更清楚也更能体现你对状态管理的理解。2.3 为什么组件化是这套项目最重要的习惯虽然这个项目规模不大但你依然要用组件化思维去写。举个例子页面顶部的导航栏不管是首页、列表页、详情页都会出现你就应该把它放在templates/base.html里面然后其他页面继承它。这样统一修改导航、底部信息只用改一个文件答辩前临时想调整UI也不容易出错。函数和逻辑也一样。计算购物车总价是一个很常用的逻辑你应该封装成一个方法而不是在每个视图中重复写一遍。很多同学前期写得很爽后期发现订单结算金额和购物车页面金额对不上就是因为他们没有统一的计算入口。3. 核心功能实现与实操要点3.1 用户注册与登录的细节处理用户模块是进入商城的第一个环节。使用Django内置的django.contrib.auth可以省去很多麻烦密码加密、用户认证都由框架完成。我们唯一要扩展的是用户信息比如联系方式、收货地址。注册视图的逻辑很简单但有一个细节需要特别注意表单提交之后要做两次校验一次是Django表单的is_valid()另一次是判断用户名是否重复。Django自带的UserCreationForm其实已经做了这些但它的界面比较简陋。如果你要自定义表单最好加上密码、确认密码的字段验证。登录页做好之后一定要记得在模板中加一个csrf_token。很多新手第一次写Django表单报403 Forbidden就是因为忘了这个。废了好大力气检查视图代码其实问题就出在模板里少写了一行标签。3.2 蛋糕商品列表与分类筛选蛋糕列表页的主要逻辑就是从数据库里查询商品然后按分类过滤。这里有一个性能上的小技巧尽量用select_related或者prefetch_related来减少查询次数。比如商品关联分类你在模板里经常要显示蛋糕.category.name如果不优化每显示一个商品都要多查一次分类表数据量一大页面速度就会下降。列表样式可以用卡片网格每个蛋糕卡片包括一张图片、名称、价格和“加入购物车”按钮。图片的存储方式建议用ImageFieldMEDIA配置要在settings.py里设置好。注意当你的DEBUG设为True时django自带的开发服务器是可以直接访问媒体文件但一旦部署上线就需要用Nginx或者云存储来处理图片访问这一点很多论文里也会提一下。3.3 购物车实现方案与价格计算陷阱购物车是本项目中最容易写崩的部分。如果你决定用Session方式核心思想是request.session[cart] { 1: {name: 提拉米苏, price: 128, quantity: 2}, 3: {name: 草莓慕斯, price: 98, quantity: 1}, }更新购物车时只要对字典做键值操作然后重新赋值给request.session即可。要注意的是Session数据默认存的是JSON所以键必须用字符串不能直接用整数。在计算价格时不要直接使用Session里保存的价格因为价格如果在后台被修改Session里的旧价格会导致订单金额错误。电商项目的基本原则是展示环节可以从Session读取但是生成订单时必须重新从数据库查询蛋糕的实时价格再乘以数量计算总价。这样能避免很多答辩时的逻辑漏洞。3.4 订单生成与库存扣减的唯一正确姿势生成订单是整个项目最核心的事务逻辑因为涉及到“创建订单记录、写入订单项、扣减库存、清空购物车”四件事。为了保证一致性应该把它们包在一个事务里from django.db import transaction with transaction.atomic(): order Order.objects.create(useruser, total_amounttotal) for item in cart_values: cake Cake.objects.select_for_update().get(iditem[cake_id]) if cake.stock item[quantity]: raise ValueError(f{cake.name} 库存不足) cake.stock - item[quantity] cake.save() OrderItem.objects.create(orderorder, cakecake, pricecake.price, quantityitem[quantity])这段代码里最容易被忽略的是select_for_update()它的作用是锁定被查询的蛋糕记录防止两个用户同时下单导致超卖。在答辩时能把“超卖”和“锁”这两个概念讲出来分数会明显不一样。3.5 后台管理与权限控制的前后两端后台管理有两种写法一种是直接用Django Admin另一种是自己定制一个后台视图。前者开发效率高写代码很少但页面风格很固定后者更像是真正的后台系统开发。对于蛋糕商城题目我建议两者结合先用Admin刷上线快速看到数据管理效果再自定义一套后台首页用图表展示商品销量、订单数量、库存预警等信息这样论文里可以写“基于Admin进行二次定制”。权限控制方面Django自带的login_required装饰器和user.is_staff判断已经足够。后台管理界面的所有视图都要加上这两个条件否则任何人都能通过URL直接访问后台地址修改商品。这个安全问题是我见过不少项目里实际存在的漏洞务必要注意。4. 实操过程记录与代码层面的关键实现4.1 项目创建与初始化步骤整套项目我从头到尾的操作步骤如下你可以按这个顺序逐步复现。# 创建虚拟环境 python -m venv venv # 激活虚拟环境Windows venv\Scripts\activate # 激活虚拟环境macOS/Linux source venv/bin/activate # 安装Django pip install django # 创建项目 django-admin startproject cake_shop cd cake_shop # 创建app python manage.py startapp goods python manage.py startapp cart python manage.py startapp orders python manage.py startapp usercenter这里app名字最好见名知义不要起app1、app2这种名字文本里排出来不好看答辩时也不好讲。接下来在settings.py的INSTALLED_APPS里注册所有app然后配置数据库DATABASES { default: { ENGINE: django.db.backends.mysql, NAME: cake_shop, USER: root, PASSWORD: 你的密码, HOST: 127.0.0.1, PORT: 3306, } }如果你用的是SQLite直接把ENGINE改成django.db.backends.sqlite3并且把NAME设置为BASE_DIR / db.sqlite3。4.2 模型类设计与注册蛋糕商品模型是核心以它为例from django.db import models from django.utils import timezone class Category(models.Model): name models.CharField(分类名称, max_length50) sort models.IntegerField(排序, default0) class Meta: verbose_name 蛋糕分类 verbose_name_plural verbose_name def __str__(self): return self.name class Cake(models.Model): category models.ForeignKey(Category, on_deletemodels.CASCADE, verbose_name分类) name models.CharField(蛋糕名称, max_length100) price models.DecimalField(价格, max_digits8, decimal_places2) stock models.IntegerField(库存, default100) description models.TextField(描述, blankTrue) image models.ImageField(图片, upload_tocakes/, blankTrue) status models.BooleanField(上架状态, defaultTrue) created_time models.DateTimeField(创建时间, defaulttimezone.now) class Meta: verbose_name 蛋糕 verbose_name_plural verbose_name def __str__(self): return self.nameDecimalField而不是FloatField这是一个很容易被忽略的细节。浮点数在计算金额时会有精度问题0.1加0.2可能变成0.30000000000000004而Decimal不会有这个问题价格字段必须用它。做完模型之后执行python manage.py makemigrations python manage.py migrate然后在项目根目录创建一个admin.py的注册文件把模型导入注册进去就可以先在后台上手动添加几款蛋糕测试。4.3 视图逻辑与URL路由分配以商品列表为例正常分页逻辑是这样from django.shortcuts import render, get_object_or_404 from django.core.paginator import Paginator from goods.models import Cake, Category def cake_list(request, category_idNone): cakes Cake.objects.filter(statusTrue).select_related(category) if category_id: cakes cakes.filter(category_idcategory_id) paginator Paginator(cakes, 12) page_number request.GET.get(page) page_obj paginator.get_page(page_number) return render(request, goods/list.html, { page_obj: page_obj, categories: Category.objects.all(), current_category_id: category_id, })关于路由URL命名要规范化用namecakes:list、namecarts:add这种命名空间不要在模板里硬编码/cakes/list/。这样做的好处是如果你以后改变了URL路径模板里的静态地址不会跟着失效不然调试起来会非常痛苦。购物车视图我用一个类来管理把所有方法封在一起class CartManager: def __init__(self, session): self.session session cart session.get(cart) if not cart: cart session[cart] {} self.cart cart def add(self, cake_id, quantity1): cake_id str(cake_id) if cake_id in self.cart: self.cart[cake_id][quantity] quantity else: cake Cake.objects.get(idint(cake_id)) self.cart[cake_id] { name: cake.name, price: str(cake.price), quantity: quantity, } self.save() def save(self): self.session.modified True这样一来你在视图里只需要cart CartManager(request.session) cart.add(request.POST.get(cake_id))代码既干净又方便后续写测试。4.4 页面继承与模板公共部分在templates/base.html中写全局导航栏和底部信息!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title{% block title %}蛋糕商城{% endblock %}/title link relstylesheet hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css /head body {% include includes/navbar.html %} main classcontainer my-4 {% block content %}{% endblock %} /main {% include includes/footer.html %} /body /html子页面只需要写{% extends base.html %} {% block title %}商品列表{% endblock %} {% block content %} div classrow {% for cake in page_obj %} div classcol-md-3 mb-4 div classcard img src{{ cake.image.url }} classcard-img-top alt{{ cake.name }} div classcard-body h5 classcard-title{{ cake.name }}/h5 p classcard-text{{ cake.price }}/p a href{% url carts:add cake.id %} classbtn btn-primary加入购物车/a /div /div /div {% endfor %} /div {% endblock %}这里有一个新手的常见疑问图片字段没有上传时调用.image.url会报错。解决方法是模板中判断一下{% if cake.image %} img src{{ cake.image.url }} {% else %} img src/static/img/default.png {% endif %}4.5 订单与支付模拟流程订单创建视图建议这样设计把表单校验和事务逻辑分开login_required def order_create(request): cart CartManager(request.session) if not cart.cart: return redirect(carts:detail) if request.method POST: form OrderForm(request.POST) if form.is_valid(): try: with transaction.atomic(): order form.save(commitFalse) order.user request.user order.total_amount cart.total_amount() order.save() for cake_id, item in cart.cart.items(): cake Cake.objects.select_for_update().get(pkint(cake_id)) if cake.stock item[quantity]: raise ValueError(库存不足) cake.stock - item[quantity] cake.save() OrderItem.objects.create(orderorder, cakecake, cake_namecake.name, pricecake.price, quantityitem[quantity]) cart.clear() return redirect(orders:payment, order.id) except ValueError as e: form.add_error(None, str(e)) else: form OrderForm() return render(request, orders/checkout.html, {form: form, cart: cart.cart})支付页面就做得很朴素展示订单金额和“确认支付”按钮点击后直接把状态改为paid。如果你想让项目看起来更有亮点可以增加一个“支付码模拟扫描二维码”的步骤把支付状态分为待支付、已支付、已取消三个阶段状态变化用Django的IntegerField或者官方推荐的TextChoices表示即可。5. 调试、排错与部署常见问题实录5.1 Session购物车数据不更新的问题这个问题很多人都遇到过往购物车里加了商品页面刷新后数量还是旧的必须重新登录才能看到。原因通常是没有设置request.session.modified True。Django默认只会在会话被修改时保存如果你只对session[cart]里的嵌套字典做了修改外层没有重新赋值Django无法识别变化。简单记一下凡是修改了Session中的可变对象比如字典里的值然后想让Django保存就必须把modified设为True。如果你懒得每次手动写也可以在settings.py里设置SESSION_SAVE_EVERY_REQUEST True但它会让所有请求都写Session性能差点不建议用于生产。5.2 图片上传后页面无法显示这个也是高频问题。当你使用ImageField时开发环境下访问媒体文件需要两步操作。第一步在根路由urls.py里加from django.conf import settings from django.conf.urls.static import static if settings.DEBUG: urlpatterns static(settings.MEDIA_URL, document_rootsettings.MEDIA_ROOT)第二步确认settings.py中有MEDIA_URL /media/ MEDIA_ROOT BASE_DIR / media否则用户上传的图片在列表页就是不显示浏览器控制台会报404。这个配置属于“非文档必写但实际必配”的经典内容。5.3 表单提交出现403错误如前面所说Django内置了CSRF防护所有以POST方式提交的自定义表单都需要在form标签内部加入{% csrf_token %}。忘了加的时候提交后返回的是一张错误页面中文信息是“CSRF验证失败”。排查方向就两个第一模板里是否加了这个标签第二如果是AJAX提交请求头是否带了X-CSRFToken。5.4 部署时静态文件收集失败很多同学本机开发一切正常一放到服务器上就发现样式全丢了。原因在于生产环境DEBUGFalse时Django不再自动托管静态文件。你需要先在项目根目录的settings.py中设置STATIC_ROOT BASE_DIR / staticfiles然后执行python manage.py collectstatic把项目中使用到的所有静态文件集中复制到staticfiles目录再配置Nginx将/static/请求映射到这个目录。媒体文件同理需要把/media/映射到MEDIA_ROOT目录。这块如果学校只要求在本地演示不做线上部署你可以跳过但论文里要把这个思路写出来作为后续工作。5.5 管理员后台操作时外键下拉框数据太多当你的蛋糕商品数量增加以后在Admin后台或者自定义后台的表单里外键字段下拉框会变得很长操作效率低。解决方案是使用Django Admin的autocomplete_fields或者在下拉框对应位置上手动限制列表数据量。这个问题虽然不是核心逻辑但能展示你对细节的把控。6. 项目定制化与答辩亮点扩展建议6.1 如果时间允许加一个“库存预警”功能在后台首页按库存数量从低到高列出前10个商品并用红色标出少于某个阈值的蛋糕。实现起来非常简单只需要一条查询low_stock_cakes Cake.objects.filter(stock__lte10).order_by(stock)但放在后台面板上视觉效果会非常直观答辩时老师一眼就能看出你做了“数据可视化”相关的工作。6.2 加一个“订单状态历史”功能很多商城题目要求订单有状态但状态变化不会留下记录。你可以增加一张OrderStatusLog表记录每次订单从“待支付”变成“已支付”的时间、操作人。这样一来你不仅完成了商城的基础需求还顺手做成了“审计日志”类的功能这在项目文档里可以单独开一小节。6.3 模板样式定制的性价比你不需要自己手写CSS推荐去Bootswatch官网下载一个免费的Bootstrap主题替换掉默认的Bootstrap样式文件。这样整个商城的观感会从“课堂练习”变为“正规网站”成本几乎为零。修改方式也很简单只需要替换模板中引用的CSS文件路径。6.4 答辩演示时的操作顺序演示时不要一上来就逛商品。建议按照这个流程先登录管理员后台添加一个蛋糕分类再添加两款蛋糕并设置库存然后切换回用户端注册一个新账号选购商品加入购物车结算下单模拟支付最后回到后台查看新订单点击发货把订单状态改成已发货。这个流程把项目的所有业务痛点都覆盖了既完整又有故事性。7. 最后的几点经验体会我在反复调试类似项目之后最想提醒后来人的是不要过度依赖网上那些“一键生成的毕设源码”。你下载别人现成的代码虽然能在第一个晚上就跑起来但你会完全失去对业务逻辑的掌控感。等到答辩老师随便问一句“购物车为什么用Session而不是数据库”你很难给出让人信服的回答。自己亲手敲一遍代码哪怕中间报错几十次这个过程本身才是毕设真正的价值所在。如果你确实要参考现成项目也建议只把源码当作参考资料自己新建一个Django项目照着核心逻辑重新写一遍。你会发现很多看起来神秘的代码拆开之后其实就是CRUD加状态判断。遇到报错不要慌阅读报错信息的第一行它往往已经告诉你问题出现在哪个文件、哪一行了。把项目做完再回头看看刚开始写的第一版视图函数那种看到自己成长的直观感受可能是这个项目带给你的最大收获。