简介一份面向高校学生成绩管理场景的综合项目源码包涵盖学生信息录入、成绩统计分析、课程/教师/班级管理、数据可视化展示、多维度查询筛选与用户权限控制等核心模块既适合课程设计、毕业设计参考也可作为面试手撕代码的高频备战素材。包内共 29 个文件以 .h/.cpp 源码、.sln/.vcxproj 工程配置、.txt/.docx/.pdf 说明文档及 .vsdx UML 图为主整体大小约 3.72MB。已有 110 人学习下载。包内附带课程设计任务书、UML 设计图、附加说明文档与可编译的工程文件能帮助学习者快速定位各功能模块的代码实现理解项目从需求分析、模块划分到界面交互的完整链路代码中权限控制、成绩统计、可视化图表等逻辑与面试手撕题高度相关适合用来练习和梳理思路若有二次开发需求也能基于此快速扩展。1. 为什么又双叒做个学生成绩管理系统需求本质与技术选型1.1 这个项目到底解决了什么痛点先说个真实场景。我之前帮一所高职院校的教务处做过一个临时工具他们的成绩管理还停留在教务系统导Excel再人工汇总的阶段。到了期末老师要把成绩从纸质登分表誊到电子表格教务干事要把不同老师交上来的表格汇总成班册、系册再算及格率、平均分、排名。一两个班还行全校几百个班级光数据清洗就能让人怀疑人生。更麻烦的是不同老师交上来的Excel格式五花八门有的学号是文本有的学号被Excel自动转成了科学计数法有的分数列里混着缺考缓考这样的文字汇总的时候全是坑。所以这个基于Python MySQL PyQt5的高校学生成绩综合管理系统本质上不是一个作业项目而是把教务场景里最重复、最容易出错的几个环节——学生信息录入、成绩统计、多维度查询筛选、数据可视化——收敛到一个桌面应用里。Python负责逻辑处理MySQL负责数据持久化PyQt5负责图形界面。整个系统最终交付的是一个可以双击运行的exe教务干事不需要懂SQL也不需要会Python打开就能用。对于正在学Python的人这个项目最大的价值在于它把Python语法、数据库设计、GUI开发、数据分析这几个孤立的技能点串成了完整闭环。你能看到一张前端界面上的按钮是怎么一步步变成MySQL里的一行记录再变成统计图表上的一个数据点的。1.2 Python MySQL PyQt5的组合逻辑有人可能会问现在Web管理系统那么多为什么非要用PyQt5做桌面端我当时的判断有三点。第一教务场景是典型的单机多人轮流用模式。办公室一台电脑谁需要谁登录没有公网访问需求。这种情况下桌面应用比Web应用少一层服务器部署少一堆端口和防火墙配置对非技术背景的使用者更友好。第二PyQt5对数据处理类界面的开发效率极高。QTableView直接绑定模型QChart画统计图QStackedWidget切换页面QSS改皮肤整套东西学一遍大概需要一两周但写出来的界面稳定性和响应速度都相当能打。第三Python的pandas可以直接处理成绩数据的统计分析MySQL做数据持久化比SQLite更适合多用户轮流写的场景。虽然SQLite也能用但高校教务数据动辄几万条而且并发写入场景比想象中多——两个老师同时录入成绩时SQLite的锁机制会让人抓狂。MySQL是更稳妥的选择。技术栈之外的另一个关键决策是这个系统必须用角色-权限模型而不是所有人一套界面。学生只能查自己的成绩老师能录入和修改所授课程的成绩教务员能管理所有基础数据管理员能分配账号和查看日志。所以在设计数据库和界面架构之前权限模型必须想清楚否则后面改起来非常痛苦。2. 数据库设计成绩系统的地基不能糊弄2.1 六张核心表的字段设计与关联关系这个项目的数据库我用了最经典的关系模型一共六张核心表用户表user、学生表student、教师表teacher、班级表class_、课程表course、成绩表score。注意班级表的表名我用了class_而不是class因为class在MySQL里是保留字直接用会报语法错误这是新手最容易踩的第一个坑。各表的字段设计如下表名核心字段说明userid, username, password, role, statusrole区分admin/teacher/studentpassword存SHA256哈希studentsid, name, gender, birth_date, class_id, phone, addresssid为学号唯一索引class_id外键关联班级teachertid, name, gender, title, phone, departmenttid为教师编号class_cid, class_name, grade, major, department班级名称如计算机2101班grade为入学年份coursecid, course_name, credit, hours, teacher_idteacher_id标识授课教师scoreid, student_id, course_id, score, semester, exam_type唯一约束(student_id, course_id, semester, exam_type)成绩表是整张数据模型的核心我加了一个联合唯一索引UNIQUE(student_id, course_id, semester, exam_type)目的是防止同一个学生同一学期同一门课被录入两次成绩。这个约束在数据库层面兜底比在应用层判断可靠得多。2.2 外键约束还是应用层控制这个项目里我选择了部分使用外键的策略。student表的class_id、course表的teacher_id、score表的student_id和course_id都设置了外键约束。这样做的好处是删除一个学生时数据库会阻止你直接删掉一个还有成绩记录的学生必须先把成绩删掉才能删学生避免产生孤儿数据。但我在实际项目中保留了一个例外user表和student表、teacher表之间没有设外键而是通过用户名username作为逻辑关联。原因在于账号生命周期和学籍生命周期不一致——一个学生退学了student记录可以保留归档但user账号可能已经禁用一个老师离职了teacher信息可以留档但账号要转给其他用户。如果强加外键会把这些本来合理的业务操作变得很难受。初始化数据是另一个容易忽略的点。系统首次启动时需要预置一个管理员账号admin/admin123以及一个默认的超级班级用于兜底。我写了一个init_db.py脚本检测到数据库没有表就自动建表并写入预置数据避免交付后还要手动执行SQL文件。2.3 中文乱码问题一次性说清MySQL存中文90%的乱码问题都出在连接层而不是数据库层。我的做法是CREATE DATABASE student_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;然后在PyQt5的连接字符串里显式指定charsetself.conn pymysql.connect( hostlocalhost, userroot, passwordyour_password, databasestudent_db, charsetutf8mb4, cursorclasspymysql.cursors.DictCursor )注意顺序先建库时指定utf8mb4再连接时指定charsetutf8mb4两者缺一不可。如果只改数据库不改连接串页面上看到的是乱码只改连接串不改数据库SQL里插入的中文会变成问号。另外PyQt5的QLineEdit是Unicode字符串Python3的str也是Unicode这层不会出问题出问题一定是在Python往MySQL写入或读取的这个环节。3. PyQt5界面骨架从登录窗口到主窗体的跳转逻辑3.1 登录窗口的权限分流系统的入口是登录窗口。我用的是QDialog QLineEdit QPushButton的组合界面做得很克制一个logo区、两个输入框、两个按钮。登录请求会走下面的逻辑def check_login(self): username self.edit_user.text().strip() password self.edit_pass.text().strip() if not username or not password: QMessageBox.warning(self, 提示, 用户名和密码不能为空) return user self.db.get_user_by_username(username) if not user or user[password] ! hashlib.sha256(password.encode()).hexdigest(): QMessageBox.warning(self, 错误, 用户名或密码错误) return if user[status] ! 1: QMessageBox.warning(self, 错误, 该账号已被禁用请联系管理员) return self.accept() self.main_window MainWindow(user, self.db) self.main_window.show()这里有几个细节值得展开。密码存的是SHA256哈希而不是明文哪怕数据库被拖走密码也不会直接暴露。查询用户时用username字段精确匹配而不是模糊查询避免同一个前缀的账号互相干扰。status字段是账号启停状态被禁用的账号在任何角色下都不能登录。登录成功后把user对象和数据库连接对象一起传给MainWindow构造函数。为什么要把db对象传过去而不是在MainWindow里重新建连接因为MySQL连接是有上限的每次登录都新建一条连接长时间使用后很容易达到max_connections。整个应用生命周期内共享一个连接配合统一的查询方法是桌面应用更合理的做法。3.2 主窗体的QStackedWidget页面管理主窗体的架构我用的是QMainWindow QToolBar QStackedWidget。左侧或者顶部放置功能导航按钮右侧是QStackedWidget每个功能模块对应一页。点击按钮时通过setCurrentIndex切换页面整个过程不用重新创建窗口响应速度极快。self.stack QStackedWidget() self.page_student StudentPage(self.db) self.page_score ScorePage(self.db) self.page_statistics StatisticsPage(self.db) self.page_course CoursePage(self.db) self.page_teacher TeacherPage(self.db) self.page_class ClassPage(self.db) self.page_user UserPage(self.db) self.stack.addWidget(self.page_student) self.stack.addWidget(self.page_score) self.stack.addWidget(self.page_statistics) self.stack.addWidget(self.page_course) self.stack.addWidget(self.page_teacher) self.stack.addWidget(self.page_class) self.stack.addWidget(self.page_user)每个Page类继承QWidget内部自己管理布局和数据加载逻辑。这样做的好处是模块之间完全解耦——StudentPage里改样式不会影响ScorePage新增一个功能模块只需要新建一个Page类然后addWidget进去就行。QSS样式方面我建议先做一个整体配色方案而不是每个控件单独设置样式。比如定义一个全局的QSS文件设置QPushButton的背景色、QTableView的隔行变色、QHeaderView的高度等QPushButton { background-color: #4A90D9; color: white; border: none; padding: 6px 16px; border-radius: 4px; } QPushButton:hover { background-color: #357ABD; } QTableView { gridline-color: #E0E0E0; alternate-background-color: #F7F9FC; }但要注意PyQt5不会自动加载QSS文件需要手动读取并setStyleSheet。我一般放在主窗体的初始化方法里with open(style.qss, r, encodingutf-8) as f: self.setStyleSheet(f.read())3.3 表格控件选QTableWidget还是QTableView这是PyQt5开发中非常典型的选择题。QTableWidget更适合数据量小、简单展示的场景它直接把单元格数据塞进去就行代码简单但性能上限低。QTableView配合QAbstractTableModel更适合数据量大、需要排序筛选的场景但要写Model类代码量翻倍。我的选择是管理页面学生管理、课程管理用QTableWidget因为数据量通常在一两千条以内够用且清爽成绩查询和统计报表页面用QTableView 自定义Model因为可能出现上万条成绩记录QTableWidget遇到大数据量会明显卡顿。如果你不想写完整的QAbstractTableModel还有一个折中方案继续用QTableWidget但只加载当前页的数据用setRowCount(0)清空后分页填充。实测下来单页500行以内完全流畅够大多数场景用了。4. 学生信息录入、成绩管理与多维度查询的落地细节4.1 表单校验光有界面输入框是不够的学生信息录入页面我用了QFormLayout QLineEdit QComboBox QDateEdit的组合。界面本身很简单难的是校验逻辑。我在录入时做了四层校验必填校验学号、姓名、班级不能为空学号必须是8位数字或者你学校规定的学号位数唯一性校验学号不能重复这个靠查数据库确认而不是只靠前端判断格式校验出生日期用QDateEdit限制格式手机号用正则判断是否11位数字逻辑校验入学年份和班级年级要匹配不能出现2020级的班级里录入一个2019级的学生def validate_student(self): sid self.edit_sid.text().strip() name self.edit_name.text().strip() if not re.fullmatch(r\d{8}, sid): QMessageBox.warning(self, 提示, 学号必须为8位数字) return False if self.db.check_student_sid_exists(sid): QMessageBox.warning(self, 提示, 该学号已存在) return False if not name: QMessageBox.warning(self, 提示, 姓名不能为空) return False if self.combo_class.currentData() is None: QMessageBox.warning(self, 提示, 请选择班级) return False return True校验通过后再组装成一个字典执行INSERT语句。整个过程先校验后入库能有效减少脏数据。成绩录入页面的校验思路类似但额外增加了成绩范围校验0到100之间的数字或者允许缺考/缓考这样的特殊值。我的做法是分数列用一个QLineEdit但用QDoubleValidator限制输入范围并保留状态列选择正常/缺考/缓考。4.2 多维度查询SQL拼接的正确姿势多维度查询筛选是这个系统的重头戏。查询条件包括院系、班级、学生姓名/学号、课程名称、学期、分数区间以及是否及格等组合条件。最直观的做法是把这些条件用if判断拼进SQL语句里conditions [] params [] if class_id: conditions.append(s.class_id %s) params.append(class_id) if keyword: conditions.append((s.name LIKE %%s OR s.sid LIKE %%s)) params.append(f%{keyword}%) params.append(f%{keyword}%) if course_id: conditions.append(sc.course_id %s) params.append(course_id) if score_min is not None: conditions.append(sc.score %s) params.append(score_min) ... sql SELECT ... FROM ... if conditions: sql WHERE AND .join(conditions)这里有个非常关键的习惯所有值都用%s参数化占位符而不是直接拼字符串。原因有两个。第一是防SQL注入哪怕这只是一个校内系统输入框里的内容也不能被当作SQL指令执行。第二是省事不需要手动处理引号转义问题姓名里有单引号比如艾力·买买提也不会炸。查询结果用pandas DataFrame接一下再转成QTableWidget的数据df pd.read_sql(sql, self.db.conn, paramsparams) self.table.setRowCount(len(df)) for i, row in df.iterrows(): for j, value in enumerate(row): self.table.setItem(i, j, QTableWidgetItem(str(value)))为什么用pandas因为后面做统计数据可视化也要用DataFrame一套数据从查询到展示到画图全程不离开pandas少写很多转换代码。4.3 导出Excel教务场景的隐藏刚需你别小看导出功能。在真实教务场景里老师录完成绩后第一件事就是把成绩表导出成ExcleExcel发给我所以这个功能必须有。我用的是pandas openpyxldf.to_excel(成绩导出.xlsx, indexFalse, sheet_name成绩表)如果导出内容包含多张表比如全班成绩汇总表和各科统计分析表可以用pd.ExcelWriter写多个sheetwith pd.ExcelWriter(统计报表.xlsx, engineopenpyxl) as writer: df_score.to_excel(writer, sheet_name成绩明细, indexFalse) df_stat.to_excel(writer, sheet_name统计分析, indexFalse)这里的坑是如果目标文件已经被Excel打开写入会报PermissionError最好在导出时弹一个文件保存对话框让用户自己选路径而不是固定写到某个目录。5. 成绩统计分析均值、排名、分段统计与图表可视化5.1 统计指标的计算逻辑成绩分析模块是区别于普通CRUD系统的关键也是评委、答辩老师最关注的部分。我实现了三类统计第一类是基础描述统计。某个班级某门课程的平均分、最高分、最低分、及格率、优秀率。SQL写法是SELECT AVG(score) AS avg_score, MAX(score) AS max_score, MIN(score) AS min_score, SUM(CASE WHEN score 60 THEN 1 ELSE 0 END) / COUNT(*) AS pass_rate, SUM(CASE WHEN score 90 THEN 1 ELSE 0 END) / COUNT(*) AS excellent_rate FROM score WHERE course_id %s AND semester %s第二类是分数段分布。把成绩分成90-100、80-89、70-79、60-69、0-59五档统计每档人数。这个在SQL里用GROUP BY配合CASE WHEN区间标记实现或者用pandas的cut函数。bins [0, 59, 69, 79, 89, 100] labels [不及格, 及格, 中等, 良好, 优秀] df[等级] pd.cut(df[score], binsbins, labelslabels)第三类是排名。排名分为班内排名和年级排名。班内排名用窗口函数ROW_NUMBER() OVER (PARTITION BY class_id ORDER BY score DESC)可以搞定但MySQL 5.7不支持窗口函数5.8及以上才支持。如果部署环境的MySQL版本偏低就用Python端的排序代替df[rank] df.groupby(class_id)[score].rank(methodmin, ascendingFalse).astype(int)5.2 班级与课程维度的对比分析除了单班单科的成绩统计我还加了一个多班级对比页面。用户勾选多个班级系统计算每个班级在某一门课程上的平均分、及格率然后并排展示。这个功能的SQL核心是SELECT c.class_name, COUNT(*) AS total, AVG(sc.score) AS avg_score, SUM(CASE WHEN sc.score 60 THEN 1 ELSE 0 END) / COUNT(*) AS pass_rate FROM score sc JOIN student s ON sc.student_id s.sid JOIN class_ c ON s.class_id c.cid WHERE sc.course_id %s GROUP BY c.cid ORDER BY avg_score DESC这个对比的价值在于它能很快找出教学薄弱班一个班级平均分低但及格率也低说明这个班的基础有整体性问题不是个别学生拖后腿。5.3 QChart还是matplotlib图表可视化方案对比数据可视化我一开始用了matplotlib FigureCanvasQTAgg能画但有个问题matplotlib的风格一眼看上去就像论文插图不够现代化。后来换成了PyQt5自带的QtChart模块效果提升非常明显。对比一下两个方案对比项matplotlibQtChart外观学术风需要调样式现代简洁原生支持交互动画中文支持需要额外设置字体默认支持较好与界面集成通过FigureCanvasQTAgg嵌入直接QChartView嵌入交互能力较弱放大缩小体验一般支持悬浮提示、缩放、图例切换学习成本低中等当然如果你的PyQt5是pip安装的默认版本可能不带QtChart需要单独安装PyQtChart库或者从源码编译。我的建议是项目优先用QtChart因为它在交互上确实好用悬浮显示具体数值这个功能对教务老师来说很重要鼠标一放上去就能看到某个柱子的精确数值。绘制成绩分段分布柱状图的核心代码chart QChart() series QBarSeries() bar_set QBarSet(人数) bar_set.append([20, 35, 28, 12, 5]) series.append(bar_set) chart.addSeries(series) chart.setTitle(成绩分段分布) chart.setAnimationOptions(QChart.SeriesAnimations) axis_x QBarCategoryAxis() axis_x.append([90-100, 80-89, 70-79, 60-69, 0-59]) chart.addAxis(axis_x, Qt.AlignBottom) series.attachAxis(axis_x) axis_y QValueAxis() axis_y.setRange(0, 40) chart.addAxis(axis_y, Qt.AlignLeft) series.attachAxis(axis_y) chart_view QChartView(chart) chart_view.setRenderHint(QPainter.Antialiasing)这个页面的布局也很重要。为了让统计结果更直观我用了QSplitter左右分割左边放筛选条件选择班级、课程、学期右上放图表右下放统计明细表格。筛选条件变化时刷新图表和表格数据。整个过程实时联动体验和网页端的Dashboard很接近。6. 用户权限控制三级角色与界面级拦截6.1 角色权限矩阵权限控制是这个系统的安全底线。我设计的角色有三种每种角色的权限如下功能模块管理员教师学生学生信息录入/修改/删除是仅查看仅查看自己的信息成绩录入/修改是仅所授课程否成绩查询与统计分析是是仅自己的成绩课程管理是查看否教师管理是否否班级管理是否否用户账号管理是否否这个矩阵决定了主窗体左侧导航栏的显示逻辑学生登录后只看到我的成绩一个页面教师登录后看到学生查询、成绩录入、成绩统计三个页面管理员看到全部页面。这个在界面层做拦截就够了因为普通用户根本看不到他无权操作的按钮。6.2 服务层的二次校验界面层拦截归界面层数据库操作层还得再做一次校验。为什么因为PyQt5的signal/slot机制允许某些操作绕过界面直接触发比如在代码里调用某个Page的方法。如果服务层不做校验理论上一个懂技术的用户可以通过Python交互式环境直接操作数据库连接对象绕过界面限制。我的做法是所有涉及写操作的数据库方法都接收一个user参数方法内部先判断角色权限def insert_score(self, operator, data): if operator[role] not in (admin, teacher): raise PermissionError(无权录入成绩) if operator[role] teacher: # 教师只能给所授课程录成绩 if data[course_id] not in operator[course_ids]: raise PermissionError(不能给非本人教授的课程录入成绩) ...在权限校验之外所有写操作INSERT、UPDATE、DELETE都会写入操作日志表。日志表字段包括操作人、操作类型、操作表名、操作时间、修改前后关键字段的值。审计日志这东西平时没用但真出了成绩被误改这种事它是唯一能追溯问题的凭据。6.3 会话状态保持与超时退出桌面应用的安全问题跟Web不太一样没有session过期也没有cookies但如果一个老师登录后忘记退出而工位的电脑又不锁屏任何人都能直接看到成绩数据。所以我加了一个简单的策略主窗体检测鼠标和键盘事件超过10分钟无操作自动退出登录返回登录窗口。class MainWindow(QMainWindow): def __init__(self, user, db): ... self.idle_timer QTimer(self) self.idle_timer.timeout.connect(self.auto_logout) self.idle_timer.start(600000) # 10分钟 def mouseMoveEvent(self, event): self.idle_timer.start(600000) super().mouseMoveEvent(event) def keyPressEvent(self, event): self.idle_timer.start(600000) super().keyPressEvent(event) def auto_logout(self): self.db.logout_count 1 QMessageBox.information(self, 提示, 长时间未操作请重新登录) self.close()这里有个细节QTimer的start()会重置计时器所以每次检测到鼠标或键盘事件调用start()就等于把超时时间重置为10分钟。效果上类似滚动作业rolling session。7. 打包与部署把Python项目变成可交付的exe7.1 PyInstaller打包的必备参数项目开发完成后最让人头疼的是打包。我强烈建议直接用PyInstaller而不是py2exe或cx_Freeze因为PyInstaller对PyQt5的hook支持最完善一键打包需要的额外配置最少。我的打包命令是pyinstaller -F -w --iconapp.ico --add-data style.qss;. --name 学生成绩管理系统 main.py参数解释-F打包成单文件。注意单文件启动时会先解压到临时目录大项目的启动速度会稍慢但分发方便-w不显示命令行窗口否则用户启动时会看到一个黑框--icon程序图标--add-data把QSS样式文件打包进去。注意Windows下分隔符是分号Linux/macOS下是冒号7.2 打包后运行时报错的常见坑打包完最常见的坑有两个。第一个坑是资源路径问题。直接open(style.qss)在开发环境能跑但打包成exe后就报FileNotFoundError。因为PyInstaller把文件解压到了临时目录当前工作目录并不是临时目录。解决办法是使用sys._MEIPASS拿到运行时解压路径import sys import os def resource_path(relative_path): base_path getattr(sys, _MEIPASS, os.path.abspath(.)) return os.path.join(base_path, relative_path) with open(resource_path(style.qss), r, encodingutf-8) as f: self.setStyleSheet(f.read())第二个坑是MySQL驱动缺失。PyInstaller不一定能自动识别pymysql这个纯Python库的所有依赖。如果打包后运行报ModuleNotFoundError需要在打包命令里加hidden-import--hidden-import pymysql --hidden-import dbfr7.3 MySQL服务部署与分发环境打包只解决了客户端的问题MySQL服务端是另一件事。对这个项目我采用的方案是让用户安装MySQL Community Server然后用init_db.py脚本初始化数据库。为了降低部署门槛我在init_db.py里做了两件事自动检测数据库连接。连接失败时给出明确的错误提示检查MySQL是否启动、用户名密码是否正确、student_db数据库是否已创建建表语句全部用IF NOT EXISTS重复执行不会报错如果目标机器上不方便装MySQL还有两个替代方案把MySQL替换成MariaDB兼容性几乎无缝或者在代码里做一层数据库适配写一个DBInterface基类分别实现MySQL和SQLite两个子类根据配置文件选择使用哪种数据库。最后再分享一个打包后的小技巧我在打包完这个项目之后才意识到很多教务处的电脑还是老配置的Windows 7或者Win10内存通常只有4GB解释器版本也很旧。所以最后在分发exe的时候务必用Python 3.8或3.7编译PyQt5用5.15.2这个windows兼容性最好的版本。用新版Python 3.11打包出来的exe在老系统上可能直接报无法启动此程序因为计算机中丢失VCRUNTIME140.dll或类似的运行时错误。另外分发的时候一定把MySQL服务端的安装包和初始化说明文档一起打包成一个压缩包交付。不要把系统理解为只有一个exe文件它应该是一个完整解决方案一个数据库安装包、一个exe客户端、一个初始化脚本、一份三页纸的使用说明。这样哪怕中途换人接手也不会出现系统打不开数据库连不上这类基础问题。这个项目做完下来最大的体会是一个管理系统好不好用三分靠代码七分靠对业务场景的理解。成绩管理表面上是增删改查实际上背后是教务管理的权限边界、数据校验规则、统计维度和报表规范。把这两件事想透了用什么技术栈反而是次要的事。本文还有配套的精品资源点击获取