Django学生成绩管理系统开发实战指南-北京尧图网络

简介本资源是一套基于Django框架开发的学生成绩管理系统毕业设计项目面向计算机专业本科生及Python后端初学者解决高校教务场景中成绩管理、互评组织与综合测评分析等核心业务需求。压缩包共2000个文件总大小15MB包含45个Python后端逻辑文件含Django视图、模型与表单、353个JavaScript交互脚本、126个CSS样式文件、近1800张PNG界面截图与图标资源以及XLS成绩单模板、SQL数据库初始化脚本和MD项目说明文档结构完整、模块清晰便于理解MVC分层实现与权限控制逻辑。已有1176人学习下载项目覆盖学生端16项功能如成绩查询排序、互评周期管理、个性发展记录与超级管理员端20余项后台管理能力如班级/学生批量维护、学期互评开关、成绩导入导出附带完整可运行代码与典型界面截图适合用于课程设计参考、Django实战复现与毕业答辩材料准备。1. 为什么用 Django 做学生成绩管理系统不是 Flask 或 Spring Boot一个高校教务员每天要处理 200 条成绩录入、30 份班级成绩单导出、5 次跨学期成绩对比查询——这些操作背后不是 Excel 表格的复制粘贴而是结构化数据的增删改查、权限隔离、历史追溯与导出合规。Django 在这类中等复杂度、强数据模型、需快速交付的教育管理场景中不是“选它因为流行”而是它把 70% 的重复劳动封装进了 ORM、Admin 和 URL 路由系统里。比如定义一个Score模型后python manage.py makemigrations自动生成数据库变更脚本admin.site.register(Score)一行代码就获得带搜索、筛选、批量操作的后台界面reverse(score_detail, kwargs{pk: 123})比硬编码/score/123/更安全可靠。这正是毕业设计选 Django 的底层逻辑不为炫技而为在 8 周开发周期内稳定交付一个可演示、可扩展、能通过答辩的数据驱动系统。适合计算机专业大四学生——你不需要从零实现用户认证但必须理解User模型如何与Student关联你不必手写 SQL 分页但得知道Paginator的page_obj.object_list返回的是什么对象。2. 从零初始化 Django 学生成绩管理系统环境、结构与核心模型2.1 创建隔离环境并安装 Django 及数据库驱动毕业设计项目必须避免污染全局 Python 环境。使用venv创建独立环境是硬性要求python3 -m venv env_score source env_score/bin/activate # Linux/macOS # env_score\Scripts\activate.bat # Windows pip install --upgrade pip pip install Django4.2,5.0 # 选用 LTS 版本兼容性好文档完整提示不要用pip install django可能装最新非 LTS 版也不要跳过--upgrade pip旧版 pip 安装mysqlclient易失败。若后续需连接 MySQL必须额外安装mysqlclientpip install mysqlclient注意Windows 用户需先安装 Microsoft Visual C Build Tools 或下载预编译 wheelmacOS 用户若报错mysql_config not found需执行brew install mysql-client并设置路径。2.2 初始化项目与应用结构明确职责边界Django 项目结构直接影响后期维护。按教育业务域拆分应用更清晰django-admin startproject score_system . python manage.py startapp student python manage.py startapp course python manage.py startapp score python manage.py startapp teacher此时目录结构应为score_system/ ├── manage.py ├── score_system/ # 项目配置包settings.py, urls.py 等 ├── student/ # 学生信息学号、姓名、班级、院系 ├── course/ # 课程信息课程号、名称、学分、开课学期 ├── score/ # 成绩核心学生×课程×分数×考试类型期中/期末/补考 ├── teacher/ # 教师信息用于关联授课注意score应用名不能与score_system项目名冲突且避免用admin、auth等 Django 内置名称。每个应用只负责一个业务实体避免把所有模型塞进models.py。2.3 定义核心数据模型用 ForeignKey 构建业务关系链在score/models.py中定义成绩主模型并通过外键关联学生、课程、教师# score/models.py from django.db import models from django.contrib.auth.models import User class Student(models.Model): student_id models.CharField(max_length12, uniqueTrue, verbose_name学号) name models.CharField(max_length30, verbose_name姓名) class_name models.CharField(max_length20, verbose_name班级) department models.CharField(max_length50, verbose_name院系) def __str__(self): return f{self.student_id} {self.name} class Course(models.Model): course_code models.CharField(max_length10, uniqueTrue, verbose_name课程号) name models.CharField(max_length100, verbose_name课程名称) credit models.DecimalField(max_digits3, decimal_places1, verbose_name学分) semester models.CharField(max_length20, verbose_name开课学期) # 如 2023-2024-1 def __str__(self): return f{self.course_code} {self.name} class Teacher(models.Model): user models.OneToOneField(User, on_deletemodels.CASCADE) # 复用 Django 用户系统 employee_id models.CharField(max_length10, uniqueTrue, verbose_name工号) title models.CharField(max_length20, verbose_name职称) def __str__(self): return self.user.get_full_name() or self.employee_id class Score(models.Model): student models.ForeignKey(Student, on_deletemodels.CASCADE, verbose_name学生) course models.ForeignKey(Course, on_deletemodels.CASCADE, verbose_name课程) teacher models.ForeignKey(Teacher, on_deletemodels.SET_NULL, nullTrue, blankTrue, verbose_name任课教师) score models.DecimalField(max_digits5, decimal_places2, verbose_name成绩, help_text0.00 ~ 100.00) exam_type models.CharField( max_length10, choices[(midterm, 期中), (final, 期末), (makeup, 补考)], defaultfinal, verbose_name考试类型 ) created_at models.DateTimeField(auto_now_addTrue, verbose_name录入时间) class Meta: unique_together (student, course, exam_type) # 防止同一学生同一课程同一类型重复录入 ordering [-created_at] def __str__(self): return f{self.student.student_id} - {self.course.course_code} - {self.score}关键参数说明on_deletemodels.CASCADE删除学生时自动删除其所有成绩符合业务逻辑on_deletemodels.SET_NULL教师离职后成绩仍保留仅清空教师字段避免数据丢失unique_together数据库级约束防止重复录入比应用层校验更可靠ordering [-created_at]默认按录入时间倒序列表页首条即最新成绩。2.4 同步数据库并创建超级用户执行迁移命令将模型映射为数据库表python manage.py makemigrations python manage.py migrate python manage.py createsuperuser # 创建管理员账号用于登录 admin 后台此时 SQLite 数据库默认已生成student_student、course_course、score_score等表。若后续切换 MySQL只需修改settings.py中的DATABASES配置并确保mysqlclient已安装。3. 快速启用 Django Admin 后台定制化注册与字段控制3.1 将模型注册到 Admin 并启用搜索/过滤admin.py不是装饰器堆砌区而是业务规则落地的第一现场。以Score模型为例# score/admin.py from django.contrib import admin from .models import Student, Course, Teacher, Score admin.register(Student) class StudentAdmin(admin.ModelAdmin): list_display (student_id, name, class_name, department) search_fields (student_id, name, class_name) list_filter (department,) admin.register(Course) class CourseAdmin(admin.ModelAdmin): list_display (course_code, name, credit, semester) search_fields (course_code, name) list_filter (semester,) admin.register(Score) class ScoreAdmin(admin.ModelAdmin): list_display (student, course, score, exam_type, teacher, created_at) list_filter (exam_type, course__semester, created_at) # 支持跨表过滤course.semester search_fields (student__name, student__student_id, course__name) date_hierarchy created_at # 按日期层级导航 raw_id_fields (student, course, teacher) # 对大量数据启用 ID 输入框避免下拉卡顿字段控制逻辑解析list_display决定列表页显示哪些字段不在此列的字段不会出现在表格中search_fields支持模糊搜索student__name表示跨ForeignKey搜索学生姓名list_filter右侧边栏过滤器course__semester是 Django 的双下划线语法实现关联表字段过滤raw_id_fields当Student表有 5000 记录时普通ForeignKey下拉框会加载全部数据导致页面卡死raw_id_fields改为输入学号 ID 弹窗搜索性能提升显著。3.2 自定义 Admin 动作一键导出 Excel 成绩单毕业设计常被要求“导出功能”。Django Admin 原生不支持 Excel但可通过自定义动作快速实现# score/admin.py接上文 import csv from django.http import HttpResponse from django.utils.encoding import smart_str admin.action(description导出选中成绩为 CSV) def export_scores_as_csv(modeladmin, request, queryset): response HttpResponse(content_typetext/csv) response[Content-Disposition] attachment; filenamescores_export.csv writer csv.writer(response, quotingcsv.QUOTE_ALL) # 表头 writer.writerow([ smart_str(学号), smart_str(姓名), smart_str(课程号), smart_str(课程名称), smart_str(成绩), smart_str(考试类型), smart_str(任课教师), smart_str(录入时间) ]) # 数据行 for score in queryset.select_related(student, course, teacher): writer.writerow([ smart_str(score.student.student_id), smart_str(score.student.name), smart_str(score.course.course_code), smart_str(score.course.name), smart_str(score.score), smart_str(dict(score._meta.get_field(exam_type).choices)[score.exam_type]), smart_str(score.teacher.user.get_full_name() if score.teacher else ), smart_str(score.created_at.strftime(%Y-%m-%d %H:%M)) ]) return response # 在 ScoreAdmin 类中添加 actions [export_scores_as_csv]注意此方案导出 CSV兼容 Excel 打开而非.xlsx。若需原生 Excel应引入openpyxl库但 CSV 已满足毕业设计基本要求且无依赖风险。3.3 Admin 界面美化用 django-jazzmin 替换默认主题默认 Admin 界面简陋答辩演示时影响观感。django-jazzmin是轻量级主题无需修改模板pip install django-jazzmin在settings.py中添加INSTALLED_APPS [ jazzmin, # 必须放在 django.contrib.admin 之前 django.contrib.admin, # ... 其他 app ] JAZZMIN_SETTINGS { site_title: 学生成绩管理系统, site_header: 教务管理后台, welcome_sign: 欢迎使用成绩管理系统, copyright: Copyright © 2024, topmenu_links: [ {name: 首页, url: admin:index}, {name: 学生管理, url: admin:student_student_changelist}, {name: 成绩录入, url: admin:score_score_add}, ], }重启服务后Admin 界面即变为深蓝配色、响应式布局支持暗色模式切换——这是答辩 PPT 中“系统截图”环节最直观的加分项。4. 实现核心业务视图基于 Class-Based Views 的成绩查询与统计4.1 使用 ListView 展示学生成绩总览带分页与搜索score/views.py中定义基于类的视图替代易出错的函数式视图# score/views.py from django.shortcuts import render from django.views.generic import ListView from django.db.models import Avg, Count, Q from .models import Score, Student, Course class ScoreListView(ListView): model Score template_name score/score_list.html context_object_name score_list paginate_by 20 # 每页 20 条 def get_queryset(self): queryset Score.objects.select_related(student, course, teacher).order_by(-created_at) # 支持 GET 参数搜索 student_id self.request.GET.get(student_id) course_code self.request.GET.get(course_code) if student_id: queryset queryset.filter(student__student_id__icontainsstudent_id) if course_code: queryset queryset.filter(course__course_code__icontainscourse_code) return queryset def get_context_data(self, **kwargs): context super().get_context_data(**kwargs) context[student_id] self.request.GET.get(student_id, ) context[course_code] self.request.GET.get(course_code, ) return context对应 URL 配置score/urls.py# score/urls.py from django.urls import path from . import views urlpatterns [ path(, views.ScoreListView.as_view(), namescore_list), ]并在主urls.py中包含# score_system/urls.py from django.contrib import admin from django.urls import path, include urlpatterns [ path(admin/, admin.site.urls), path(score/, include(score.urls)), ]关键点说明select_related预加载外键关联对象避免 N1 查询每条成绩再查一次学生、课程paginate_by 20Django 自动处理分页模板中用{{ page_obj }}渲染get_queryset中的icontains实现模糊搜索比exact更符合用户直觉输“2023”匹配“20230101”学号。4.2 构建成绩统计视图聚合查询与图表数据准备毕业设计常需“各班平均分”“课程通过率”等统计。Django ORM 可直接生成 SQL 聚合# score/views.py续 from django.views.generic import TemplateView from django.db.models import Avg, Count, Case, When, FloatField, Sum class ScoreStatsView(TemplateView): template_name score/stats.html def get_context_data(self, **kwargs): context super().get_context_data(**kwargs) # 各班级平均分按班级分组 class_avg Student.objects.values(class_name).annotate( avg_scoreAvg(score__score) ).order_by(-avg_score) # 各课程通过率60分及以上为通过 course_pass_rate Course.objects.annotate( totalCount(score), passedCount(score, filterQ(score__score__gte60)), pass_rateCase( When(total__gt0, thenSum(score__score, filterQ(score__score__gte60)) * 100.0 / Count(score)), output_fieldFloatField() ) ).values(name, total, passed, pass_rate).order_by(-pass_rate) context[class_avg] class_avg context[course_pass_rate] course_pass_rate return context注意filterQ(score__score__gte60)中的双下划线表示跨ForeignKey查询score__score即Score模型的score字段。Case/When用于条件计算避免除零错误。4.3 模板渲染用 Bootstrap 4 快速搭建响应式页面score/templates/score/score_list.html示例精简版!-- score/templates/score/score_list.html -- {% load static %} !DOCTYPE html html head title成绩列表/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap4.6.2/dist/css/bootstrap.min.css relstylesheet /head body div classcontainer mt-4 h2成绩查询/h2 form methodget classmb-4 div classrow div classcol-md-4 input typetext namestudent_id classform-control placeholder请输入学号 value{{ student_id }} /div div classcol-md-4 input typetext namecourse_code classform-control placeholder请输入课程号 value{{ course_code }} /div div classcol-md-2 button typesubmit classbtn btn-primary搜索/button /div /div /form table classtable table-striped thead tr th学号/thth姓名/thth课程号/thth课程名称/th th成绩/thth类型/thth教师/th /tr /thead tbody {% for score in score_list %} tr td{{ score.student.student_id }}/td td{{ score.student.name }}/td td{{ score.course.course_code }}/td td{{ score.course.name }}/td td{{ score.score }}/td td{{ score.get_exam_type_display }}/td td{{ score.teacher.user.get_full_name|default:未指定 }}/td /tr {% endfor %} /tbody /table !-- 分页导航 -- {% if is_paginated %} nav aria-label分页 ul classpagination justify-content-center {% if page_obj.has_previous %} li classpage-itema classpage-link href?page1student_id{{ student_id }}course_code{{ course_code }}首页/a/li li classpage-itema classpage-link href?page{{ page_obj.previous_page_number }}student_id{{ student_id }}course_code{{ course_code }}上一页/a/li {% endif %} li classpage-item disabledspan classpage-link{{ page_obj.number }} / {{ page_obj.paginator.num_pages }}/span/li {% if page_obj.has_next %} li classpage-itema classpage-link href?page{{ page_obj.next_page_number }}student_id{{ student_id }}course_code{{ course_code }}下一页/a/li li classpage-itema classpage-link href?page{{ page_obj.paginator.num_pages }}student_id{{ student_id }}course_code{{ course_code }}末页/a/li {% endif %} /ul /nav {% endif %} /div /body /html模板关键细节{{ score.get_exam_type_display }}自动将exam_type字段的final值转为中文“期末”Django 模型choices的内置方法分页链接中显式拼接student_id和course_code参数保证翻页后搜索条件不丢失使用 Bootstrap 4 CDN无需本地 CSS 文件降低部署复杂度。5. 部署与调试本地开发验证、常见报错定位与生产环境准备5.1 本地开发必做三件事检查迁移、验证 Admin、测试视图 URL在manage.py runserver启动前务必执行以下验证检查迁移状态python manage.py showmigrations # 输出应全为 [X]表示所有迁移已应用登录 Admin 测试基础功能访问http://127.0.0.1:8000/admin/用createsuperuser创建的账号登录确认能增删改查Student、Course、Score。访问业务视图 URL打开http://127.0.0.1:8000/score/确认列表页正常渲染尝试搜索学号验证get_queryset逻辑生效。提示若页面报TemplateDoesNotExist检查TEMPLATES配置中DIRS是否包含templates路径若报NoReverseMatch检查urls.py是否正确include了子路由。5.2 解决三个高频报错Foreign Key 冲突、时区问题、静态文件 404报错 1IntegrityError: insert or update on table score_score violates foreign key constraint原因插入Score时引用了不存在的student_id或course_code。解决在 Admin 或表单中ForeignKey字段应使用ModelChoiceField或raw_id_fields避免手动输入 ID。开发阶段可在ScoreAdmin中添加autocomplete_fields (student, course)需 Django 3.2。报错 2RuntimeWarning: DateTimeField Score.created_at received a naive datetime原因settings.py中USE_TZ TrueDjango 默认但代码中用了datetime.now()无时区。解决统一使用timezone.now()from django.utils import timezone # 替换所有 datetime.now() 为 timezone.now()报错 3CSS/JS 404Admin 界面样式丢失原因开发模式下DEBUG TrueDjango 自动提供静态文件服务但若STATIC_URL或STATICFILES_DIRS配置错误仍会 404。解决确认settings.py包含STATIC_URL /static/ STATICFILES_DIRS [BASE_DIR / static] # 项目根目录下的 static 文件夹 # DEBUGTrue 时无需 collectstatic5.3 生产环境准备禁用 DEBUG、配置 SECRET_KEY、启用 Gunicorn毕业设计虽不需上线但答辩演示需模拟生产环境。关键步骤关闭 DEBUG 模式在settings.py中设DEBUG False并添加允许的域名ALLOWED_HOSTS [127.0.0.1, localhost] # 本地演示 # 若部署到服务器需加入服务器 IP 或域名生成强 SECRET_KEY不要用默认的django-insecure-...。运行python -c from django.core.management.utils import get_random_secret_key; print(get_random_secret_key()) # 将输出结果替换 settings.py 中的 SECRET_KEY用 Gunicorn 启动替代 runserverpip install gunicorn gunicorn score_system.wsgi:application --bind 127.0.0.1:8000 --workers 2此时访问http://127.0.0.1:8000即为生产模式DEBUGFalse下的响应。注意Gunicorn 仅处理 Python 请求静态文件仍需 Nginx 或whitenoise库托管。毕业设计本地演示gunicorn启动即代表“已具备生产部署能力”。5.4 一个实用技巧用 Django Shell 快速验证复杂查询逻辑当不确定 ORM 查询是否生成预期 SQL 时不用反复启服务。进入 Django Shellpython manage.py shell然后执行from score.models import Score from django.db import connection # 写查询 qs Score.objects.filter(student__class_name计科2021).values(course__name).annotate(avgAvg(score)) # 查看生成的 SQL print(qs.query) # 执行并查看结果 list(qs)qs.query输出的原始 SQL 可直接粘贴到数据库客户端中执行验证这是排查“查不到数据”类问题的最快路径——比翻日志、加 print 更精准。本文还有配套的精品资源点击获取

Django学生成绩管理系统开发实战指南

相关推荐

基于Proteus的51单片机PID电机控制系统仿真与调参与实现

Trae项目：.NET Core智能代码生成与Ollama集成实践

Mastra React 最佳实践：提取复杂派生逻辑，让渲染前的数据推导保持可读、可测、可评审

更多资讯

ESP32-P4 USB Host实战：从硬件供电到U盘挂载全链路解析

Python %-formatting字符串格式化详解与实战技巧

MATLAB空间博弈追逃仿真：带运动学约束的微分博弈实现

GD25Q80E NOR Flash 入门实战：从SPI时序到QSPI内存映射

用Python打造本地PDF处理利器：JOPDF批量合并、压缩、加密实战

树莓派Pico时间同步：NTP对时与RTC掉电保存方案详解

今日更新

SpacetimeDB C++ 模块库实战：用 C++20 在数据库内构建 WebAssembly 模块

别踩雷！不是所有 AI 写作工具都靠谱，2026 高校认可工具精选

SSM+MySQL幼儿园管理系统源码解析：从部署到优化

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？