简介这是一份基于PyQt5的学生信息管理系统源码包适合正在学习Python GUI编程或需要完成期末作业、毕业设计的同学。项目实现了学生信息的增删改查采用pymysql连接MySQL数据库并结合QtDesigner与pyuic完成界面设计与代码转换同时使用xlwt支持数据导出能帮助您快速掌握PyQt5与数据库的联动开发思路。资源包共34个文件包含8个Python业务逻辑脚本、7个UI界面文件、2个SQL数据库脚本以及XML配置、图片图标等辅助资源整体仅257KB目录结构清晰部署门槛低非常适合作为入门练手项目。目前已有466人学习浏览作者还附带了部署调试服务说明可在遇到环境或连接问题时提供参考。通过这套资源您既能得到可运行的学生管理项目雏形也能基于现有代码稍作改造将其扩展为更完善的课程设计或毕业设计题目实用性较强。1. 先从整体看为什么这个学生系统选PyQt5说实话学生信息管理系统这个题目在本科毕业设计里出现的频率高到几乎每个学校的软件工程、计算机科学专业都能翻出几份差不多的论文。但我见过太多人把这类项目做成“能用但讲不清楚”的状态代码能跑问两句就露馅。真正拉分的不是功能多少而是你对自己做的东西有没有完整的逻辑链路。这套基于PyQt5的个人学生信息管理系统核心价值其实是“用一套桌面GUI把数据库操作串成一个闭环”。PyQt5在这里不是配角它是整个系统的门面。选它而不是Django、Flask或者Vue最直接的理由是毕设场景下你不需要部署服务器、不需要考虑前后端分离、不需要处理跨域和网络请求一个本地程序把界面和业务全部包住演示的时候双击就能跑这点在答辩现场太重要了。另外PyQt5背后是Qt的成熟控件库表格、表单、下拉框、日期选择器都现成比Tkinter那种“控件能用但丑得没法看”的状态强太多。对一位刚接触GUI开发的本科生来说用PyQt5写出来的界面至少在观感上已经赢了第一轮。再说回“源码SQL脚本”这两个关键词。源码好理解SQL脚本才是这个项目里容易被低估的部分。很多人写完代码数据库是手工在Navicat里点的表结构根本没有沉淀成脚本文件。这会导致两个问题一是换一台电脑演示数据库环境重建非常麻烦二是论文里写“数据库设计”章节的时候拿不出清晰的建表语句。这套项目把SQL脚本单独拎出来等于补上了这个关键短板。整个项目我建议按三条线去理解界面线PyQt5控件与交互、数据线SQL脚本与增删改查、逻辑线校验、权限、状态管理。下面我拆开讲。2. 数据库设计SQL脚本才是项目的隐藏重头戏2.1 学生、课程、成绩三张核心表怎么设计看到“学生信息管理系统”这个题目第一直觉是建一张学生表就完事。但稍微想深一层一个系统至少得包含“学生维护”和“成绩查询”两个动作才算闭环。所以常规设计是三张核心表学生表、课程表、成绩表。学生表的字段建议这样定学号主键、姓名、性别、出生日期、专业、班级、联系电话、入学年份。这里有个细节学号必须用字符串而不是整数因为学号很可能以0开头或者包含字母用INT存储会直接截断数据。另一个经验是“联系电话”不要设成INT手机号超过int范围会溢出用VARCHAR(11)最稳妥。课程表相对简单课程号主键、课程名称、学分、授课教师。成绩表则是典型的关联表成绩ID自增主键、学号外键关联学生表、课程号外键关联课程表、成绩DECIMAL(5,2)。在设计成绩表时有一个经典误区把“学生姓名”和“课程名称”直接冗余到成绩表里。这样做查询确实方便但违背了第三范式。实际维护时你会发现如果学生改名或者课程改名冗余字段会变成一致性灾难。正确做法是成绩表里只存外键查询时用JOIN把名称带出来。PyQt5的QSqlQueryModel配合SQL的JOIN语句展示数据写起来一点也不费劲。2.2 为什么推荐SQLite同时保留MySQL脚本我在帮人看毕设代码时发现很多学生默认用MySQL觉得“大而全”才像正经项目。但这里有个现实问题MySQL需要安装服务、配置账号密码、设置字符集如果答辩教室的网络环境不稳定或者评委电脑上根本没有MySQL现场演示直接翻车。这套项目的SQL脚本同时兼容SQLite这种本地文件型数据库是我反复权衡后坚持的做法。SQLite的优势是零配置一个.db文件就是整个数据库程序里直接用相对路径连接即可拷走项目文件夹到任何一台Windows电脑都能跑。它的劣势是并发写入一般但对于单机演示场景完全够用。当然如果你确实想在论文里体现“采用MySQL数据库管理系统”或者导师要求必须用MySQLSQL脚本也准备好了建库建表语句你只需要在本地执行一遍再改一下db_config里的连接参数就行。两条路都通这是这个设计最聪明的地方。2.3 登录密码存储与默认账号的初始化登录是毕设系统里评委必测的点。默认账号admin、密码admin123这种硬编码方式简单是简单但一旦论文里写“系统安全性高”就很容易被追问。我的建议是密码字段不要存明文用MD5加盐的方式存储。Python标准库hashlib直接支持几行代码的事但答辩时解释的深度完全不同。SQL脚本里预先执行一条INSERT语句把账号和密码的MD5值写入用户表比如提示如果想让项目更完整可以在系统设置菜单里加上“修改密码”功能。修改密码时先校验旧密码再对新密码做同样的MD5加密后UPDATE到数据库。另外用户表最好预留一个“角色”字段分管理员和普通用户。普通用户登录后只能查询和导出不能增删改这样系统在功能逻辑上就有了权限控制的层次感。很多毕设系统直接砍掉用户模块虽然也能通过但论文“功能模块图”会显得单薄。3. 核心功能实现与实操细节3.1 登录模块验证逻辑与体验优化登录界面用PyQt5实现非常直接。QLineEdit输入账号另一个QLineEdit输入密码且设置setEchoMode(QLineEdit.Password)让输入内容显示为圆点。敲回车触发登录比手动点按钮更顺手这个细节可以加分。登录验证的核心逻辑是从QLineEdit获取输入的账号密码密码做同样的MD5加密然后用SELECT语句查询数据库。如果返回记录存在说明账号密码匹配否则弹出QMessageBox.warning提示“账号或密码错误”。这里有一个经验不要把“账号不存在”和“密码错误”分开提示统一提示能降低被暴力探测的风险虽然这个场景可能用不上但体现的是工程意识。这段代码是登录验证的核心逻辑自己写的时候可以套模板import hashlib from PyQt5.QtWidgets import QMessageBox def check_login(self): username self.ui.username_edit.text().strip() password self.ui.password_edit.text().strip() if not username or not password: QMessageBox.warning(self, 提示, 账号和密码不能为空) return encrypted_pwd hashlib.md5(password.encode(utf-8)).hexdigest() query QSqlQuery(self.db) query.prepare(SELECT role FROM user WHERE username? AND password?) query.addBindValue(username) query.addBindValue(encrypted_pwd) if query.exec_() and query.next(): self.current_role query.value(0) self.open_main_window() else: QMessageBox.warning(self, 提示, 账号或密码错误)注意prepare和addBindValue这套参数化查询的写法。直接拼接SQL字符串虽然也能跑但存在SQL注入风险而且字符串里的引号容易出错所以这块直接采用参数绑定才是正规做法。3.2 增删改查表格刷新、数据校验和查询技巧学生信息管理的主界面通常是一个QTableView展示全部学生列表右侧或上方是“新增”、“修改”、“删除”、“查询”按钮。增删改查实现的关键点在于数据模型的刷新。很多人第一次做这个功能是在每次增删改之后重新执行一遍查询语句然后再次setModel。这样虽然能显示新数据但会带来一个体验很差的问题表格回到第一页或滚动位置归零用户刚看的那条数据突然不见了。改进方式是在刷新前记录当前选中行的主键值学号刷新后遍历模型找到该学号重新选中对应行。数据校验这块我建议两个层面同时做前端控件层面用QIntValidator限制年龄输入只能为数字QRegularExpressionValidator限制手机号格式为11位数字后端数据层在写入前再校验一次确保学号不为空、成绩在0-100之间。前端校验提升体验后端校验保证数据安全两层都是为了不让脏数据进库。删除操作必须二次确认这个细节如果你忘了演示时大概率会翻车。实际测试中评委可能会随手点删除按钮如果“嗖”一下数据就没了体验极其不好。弹出的QMessageBox.question确认框问一句“确定要删除该学生吗”既安全又显专业。3.3 分页与模糊搜索的实现要点一个小系统学生数量可能就几十条很多人觉得分页没必要。但我觉得分页这个功能是展示系统“设计感”的最佳道具。QTableView搭配QSqlQueryModel默认是全量加载一旦数据量上千界面会明显卡顿。实现分页的思路是用LIMIT和OFFSET控制查询范围结合“上一页”、“下一页”、“跳转到第几页”三个按钮控制页面切换。分页有个容易踩的坑记录总条数的COUNT查询和当前页的数据查询两条SQL必须组合使用。每次翻页都要执行两个动作先统计总数计算总页数再取当前页的数据。不需要太复杂的算法但要注意当前页码超出总页数范围时的边界处理。模糊搜索是另外一个必做功能。搜索框里输入关键字实时展示匹配的学生。SQL用LIKE即可SELECT * FROM student WHERE student_id LIKE % || ? || % OR name LIKE % || ? || % OR major LIKE % || ? || %注意SQLite的字符串拼接是用||而MySQL里用的是CONCAT函数。如果你两套数据库都支持这里就得区分处理。我的做法是写两个版本的查询函数通过配置文件的db_type字段判断走哪条分支。4. 环境配置、运行与打包全流程4.1 Python环境与PyQt5安装避坑拿到源码后第一步是准备环境。Python版本建议用3.8到3.10之间太高或太低都可能遇到PyQt5的兼容性问题。装Python的时候记得勾选“Add Python to PATH”不然后续命令行操作会找不到Python。安装PyQt5用pip是最省事的pip install PyQt5 PyQt5-tools如果你是在国内网络环境下安装强烈建议先切换镜像源不然可能卡在下载阶段耗掉半小时pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simplePyQt5-tools这个包在最新版本里已经不再单独维护了如果你只需要基础控件装PyQt5就够。装完之后测试一下能否正确导入。4.2 如何初始化数据库并跑通项目项目拿到手先别急着双击main.py先把数据库初始化好不然程序会报“no such table”之类的错误。如果你的项目默认使用SQLite那么数据库文件会在首次连接时自动创建但数据表需要手动导入SQL脚本。最简单的办法是进入Python交互环境执行如下命令sqlite3 student.db .read student.sql .quit或者直接写一段Python脚本来初始化读取SQL文件内容用QSqlQuery逐条执行。我用过之后觉得写一个独立init_db.py脚本是最方便的方案后续重装环境时执行一遍就行。如果你的项目配置成MySQL那流程是在Navicat里新建一个数据库然后右键“运行SQL文件”把建表语句导入再把用户表和初始admin账号的INSERT语句一起执行。完成后检查一下db_config配置文件里的host、port、user、password是否和你本地环境一致。注意MySQL和SQLite的驱动在PyQt5里的写法不一样MySQL用QPSQL或QODBCSQLite用QSQLITE。如果你的项目里数据库连接写得比较复杂优先用SQLite模式跑通。一切就绪后在项目根目录运行python main.py看到登录窗口弹出来说明环境基本正常。4.3 PyInstaller打包成exe的注意事项答辩时能现场双击一个exe直接把系统跑起来印象分会提升不少。打包用PyInstaller是最常规的做法但这块也是坑最多的环节。基础命令很简单pip install pyinstaller pyinstaller -w -F main.py-w表示运行时不显示黑色控制台窗口-F表示打包成单个exe文件。但直接这样打包往往会遇到两个问题第一个是“No module named ‘PyQt5’”。这通常是因为打包环境下PyQt5的某些动态链接库没有被正确识别。解决办法是加--hidden-import参数比如--hidden-importPyQt5.sip。还有一个玄学但很实用的办法确保当前Python环境里只装了PyQt5不要同时装了PySide6二者共存会把打包过程彻底搞乱。第二个是exe的图标路径问题。打包后的exe在运行时如果程序里写了静态相对路径读取ui文件或图标很可能会因为当前工作目录变化而找不到文件。我的经验是在代码开头加上路径自动切换逻辑用os.path.dirname(sys.executable)确定当前exe所在目录然后把所有资源文件都放进去。数据库文件也建议放在exe同目录下程序连接数据库时用动态获取到的路径拼接这样换电脑时把整个文件夹拷走就能用。5. 常见问题与排查技巧实录5.1 运行时报错与界面显示问题我自己在边写边测的时候遇到过不少让人想摔键盘的报错整理几个高频的出来对号入座就能解决。排列第一的是“ModuleNotFoundError: No module named ‘PyQt5’”。原因基本都是当前Python解释器环境不对或者PyQt5没装。排查方式是在命令行执行pip list | findstr PyQt5确认到底装没装如果装了还报错那大概率是IDE里选择的解释器和命令行不是同一个。切换解释器到同一个虚拟环境就能解决。第二个高频问题是界面中文全部乱码。解决办法是在程序入口设置全局字体from PyQt5.QtGui import QFont app.setFont(QFont(Microsoft YaHei, 10))第三个是表格数据显示不完整或者总是显示上一次查询的残留数据。这种情况一般是QSqlQueryModel没有在重新查询前调用clear()。清掉旧模型再重新setQuery刷新就会干净很多。5.2 数据库连接与脚本执行问题在SQLite模式下最常见的报错是“database is locked”。出现这个问题的场景通常是程序还开着你又用外部工具比如SQLiteStudio打开了同一个数据库文件。桌面系统一般不会开多线程写库所以锁库基本是外部工具抢占了。把外部工具关掉程序重启就好。如果是MySQL模式下连接报错最容易忽视的是端口号。MySQL默认3306但如果你本地装了多个数据库实例端口可能被改掉了。先检查db_config里的端口号是否能对得上实际环境。还有一种情况是MySQL 8.0的密码加密方式改了老代码用的驱动连不上解决办法是安装mysql-connector或更新驱动版本。至于表格操作时提示“no such column”这类错误别怀疑不是代码的锅是SQL脚本没执行成功。重新检查一遍建表语句是否完整执行用SELECT * FROM 表名在数据库客户端里跑一遍确认字段存在。5.3 如何在毕设答辩中给项目加分最后分享一个答辩层面的经验。很多学生的毕设代码本身没问题但讲解时只会演示功能不会讲设计导致答辩得分偏低。我建议你在答辩前为这个项目准备三条回答思路第一谈到技术选型时讲清楚为什么选PyQt5而不是Web前端落脚点是“桌面端应用更适用于本地管理、数据不依赖网络、响应速度快”。第二谈到数据库设计时讲清楚三张表之间的关联关系以及为什么成绩表不冗余学生姓名。第三谈到系统安全时讲清楚密码加密和参数化查询的用意哪怕这个系统很小但工程规范是一脉相承的道理。如果答辩时间有富余你可以现场演示修改pyqt5界面上某个按钮的文字或颜色然后重新运行程序说明这个项目的“可维护性”。这个动作很加分因为证明这个项目的界面和逻辑是解耦的改动界面不会伤到业务。等这套基础代码彻底看明白后想再提升可以在学生信息管理之上加“课程成绩统计图”或者“导出Excel成绩单”的功能前者用QtCharts画柱状图后者用第三方库openpyxl生成.xlsx文件。工作量不大但论文的创新点就出来了。本文还有配套的精品资源点击获取 基于PyQt5的学生信息管理系统：从数据库设计到打包实践
简介这是一份基于PyQt5的学生信息管理系统源码包适合正在学习Python GUI编程或需要完成期末作业、毕业设计的同学。项目实现了学生信息的增删改查采用pymysql连接MySQL数据库并结合QtDesigner与pyuic完成界面设计与代码转换同时使用xlwt支持数据导出能帮助您快速掌握PyQt5与数据库的联动开发思路。资源包共34个文件包含8个Python业务逻辑脚本、7个UI界面文件、2个SQL数据库脚本以及XML配置、图片图标等辅助资源整体仅257KB目录结构清晰部署门槛低非常适合作为入门练手项目。目前已有466人学习浏览作者还附带了部署调试服务说明可在遇到环境或连接问题时提供参考。通过这套资源您既能得到可运行的学生管理项目雏形也能基于现有代码稍作改造将其扩展为更完善的课程设计或毕业设计题目实用性较强。1. 先从整体看为什么这个学生系统选PyQt5说实话学生信息管理系统这个题目在本科毕业设计里出现的频率高到几乎每个学校的软件工程、计算机科学专业都能翻出几份差不多的论文。但我见过太多人把这类项目做成“能用但讲不清楚”的状态代码能跑问两句就露馅。真正拉分的不是功能多少而是你对自己做的东西有没有完整的逻辑链路。这套基于PyQt5的个人学生信息管理系统核心价值其实是“用一套桌面GUI把数据库操作串成一个闭环”。PyQt5在这里不是配角它是整个系统的门面。选它而不是Django、Flask或者Vue最直接的理由是毕设场景下你不需要部署服务器、不需要考虑前后端分离、不需要处理跨域和网络请求一个本地程序把界面和业务全部包住演示的时候双击就能跑这点在答辩现场太重要了。另外PyQt5背后是Qt的成熟控件库表格、表单、下拉框、日期选择器都现成比Tkinter那种“控件能用但丑得没法看”的状态强太多。对一位刚接触GUI开发的本科生来说用PyQt5写出来的界面至少在观感上已经赢了第一轮。再说回“源码SQL脚本”这两个关键词。源码好理解SQL脚本才是这个项目里容易被低估的部分。很多人写完代码数据库是手工在Navicat里点的表结构根本没有沉淀成脚本文件。这会导致两个问题一是换一台电脑演示数据库环境重建非常麻烦二是论文里写“数据库设计”章节的时候拿不出清晰的建表语句。这套项目把SQL脚本单独拎出来等于补上了这个关键短板。整个项目我建议按三条线去理解界面线PyQt5控件与交互、数据线SQL脚本与增删改查、逻辑线校验、权限、状态管理。下面我拆开讲。2. 数据库设计SQL脚本才是项目的隐藏重头戏2.1 学生、课程、成绩三张核心表怎么设计看到“学生信息管理系统”这个题目第一直觉是建一张学生表就完事。但稍微想深一层一个系统至少得包含“学生维护”和“成绩查询”两个动作才算闭环。所以常规设计是三张核心表学生表、课程表、成绩表。学生表的字段建议这样定学号主键、姓名、性别、出生日期、专业、班级、联系电话、入学年份。这里有个细节学号必须用字符串而不是整数因为学号很可能以0开头或者包含字母用INT存储会直接截断数据。另一个经验是“联系电话”不要设成INT手机号超过int范围会溢出用VARCHAR(11)最稳妥。课程表相对简单课程号主键、课程名称、学分、授课教师。成绩表则是典型的关联表成绩ID自增主键、学号外键关联学生表、课程号外键关联课程表、成绩DECIMAL(5,2)。在设计成绩表时有一个经典误区把“学生姓名”和“课程名称”直接冗余到成绩表里。这样做查询确实方便但违背了第三范式。实际维护时你会发现如果学生改名或者课程改名冗余字段会变成一致性灾难。正确做法是成绩表里只存外键查询时用JOIN把名称带出来。PyQt5的QSqlQueryModel配合SQL的JOIN语句展示数据写起来一点也不费劲。2.2 为什么推荐SQLite同时保留MySQL脚本我在帮人看毕设代码时发现很多学生默认用MySQL觉得“大而全”才像正经项目。但这里有个现实问题MySQL需要安装服务、配置账号密码、设置字符集如果答辩教室的网络环境不稳定或者评委电脑上根本没有MySQL现场演示直接翻车。这套项目的SQL脚本同时兼容SQLite这种本地文件型数据库是我反复权衡后坚持的做法。SQLite的优势是零配置一个.db文件就是整个数据库程序里直接用相对路径连接即可拷走项目文件夹到任何一台Windows电脑都能跑。它的劣势是并发写入一般但对于单机演示场景完全够用。当然如果你确实想在论文里体现“采用MySQL数据库管理系统”或者导师要求必须用MySQLSQL脚本也准备好了建库建表语句你只需要在本地执行一遍再改一下db_config里的连接参数就行。两条路都通这是这个设计最聪明的地方。2.3 登录密码存储与默认账号的初始化登录是毕设系统里评委必测的点。默认账号admin、密码admin123这种硬编码方式简单是简单但一旦论文里写“系统安全性高”就很容易被追问。我的建议是密码字段不要存明文用MD5加盐的方式存储。Python标准库hashlib直接支持几行代码的事但答辩时解释的深度完全不同。SQL脚本里预先执行一条INSERT语句把账号和密码的MD5值写入用户表比如提示如果想让项目更完整可以在系统设置菜单里加上“修改密码”功能。修改密码时先校验旧密码再对新密码做同样的MD5加密后UPDATE到数据库。另外用户表最好预留一个“角色”字段分管理员和普通用户。普通用户登录后只能查询和导出不能增删改这样系统在功能逻辑上就有了权限控制的层次感。很多毕设系统直接砍掉用户模块虽然也能通过但论文“功能模块图”会显得单薄。3. 核心功能实现与实操细节3.1 登录模块验证逻辑与体验优化登录界面用PyQt5实现非常直接。QLineEdit输入账号另一个QLineEdit输入密码且设置setEchoMode(QLineEdit.Password)让输入内容显示为圆点。敲回车触发登录比手动点按钮更顺手这个细节可以加分。登录验证的核心逻辑是从QLineEdit获取输入的账号密码密码做同样的MD5加密然后用SELECT语句查询数据库。如果返回记录存在说明账号密码匹配否则弹出QMessageBox.warning提示“账号或密码错误”。这里有一个经验不要把“账号不存在”和“密码错误”分开提示统一提示能降低被暴力探测的风险虽然这个场景可能用不上但体现的是工程意识。这段代码是登录验证的核心逻辑自己写的时候可以套模板import hashlib from PyQt5.QtWidgets import QMessageBox def check_login(self): username self.ui.username_edit.text().strip() password self.ui.password_edit.text().strip() if not username or not password: QMessageBox.warning(self, 提示, 账号和密码不能为空) return encrypted_pwd hashlib.md5(password.encode(utf-8)).hexdigest() query QSqlQuery(self.db) query.prepare(SELECT role FROM user WHERE username? AND password?) query.addBindValue(username) query.addBindValue(encrypted_pwd) if query.exec_() and query.next(): self.current_role query.value(0) self.open_main_window() else: QMessageBox.warning(self, 提示, 账号或密码错误)注意prepare和addBindValue这套参数化查询的写法。直接拼接SQL字符串虽然也能跑但存在SQL注入风险而且字符串里的引号容易出错所以这块直接采用参数绑定才是正规做法。3.2 增删改查表格刷新、数据校验和查询技巧学生信息管理的主界面通常是一个QTableView展示全部学生列表右侧或上方是“新增”、“修改”、“删除”、“查询”按钮。增删改查实现的关键点在于数据模型的刷新。很多人第一次做这个功能是在每次增删改之后重新执行一遍查询语句然后再次setModel。这样虽然能显示新数据但会带来一个体验很差的问题表格回到第一页或滚动位置归零用户刚看的那条数据突然不见了。改进方式是在刷新前记录当前选中行的主键值学号刷新后遍历模型找到该学号重新选中对应行。数据校验这块我建议两个层面同时做前端控件层面用QIntValidator限制年龄输入只能为数字QRegularExpressionValidator限制手机号格式为11位数字后端数据层在写入前再校验一次确保学号不为空、成绩在0-100之间。前端校验提升体验后端校验保证数据安全两层都是为了不让脏数据进库。删除操作必须二次确认这个细节如果你忘了演示时大概率会翻车。实际测试中评委可能会随手点删除按钮如果“嗖”一下数据就没了体验极其不好。弹出的QMessageBox.question确认框问一句“确定要删除该学生吗”既安全又显专业。3.3 分页与模糊搜索的实现要点一个小系统学生数量可能就几十条很多人觉得分页没必要。但我觉得分页这个功能是展示系统“设计感”的最佳道具。QTableView搭配QSqlQueryModel默认是全量加载一旦数据量上千界面会明显卡顿。实现分页的思路是用LIMIT和OFFSET控制查询范围结合“上一页”、“下一页”、“跳转到第几页”三个按钮控制页面切换。分页有个容易踩的坑记录总条数的COUNT查询和当前页的数据查询两条SQL必须组合使用。每次翻页都要执行两个动作先统计总数计算总页数再取当前页的数据。不需要太复杂的算法但要注意当前页码超出总页数范围时的边界处理。模糊搜索是另外一个必做功能。搜索框里输入关键字实时展示匹配的学生。SQL用LIKE即可SELECT * FROM student WHERE student_id LIKE % || ? || % OR name LIKE % || ? || % OR major LIKE % || ? || %注意SQLite的字符串拼接是用||而MySQL里用的是CONCAT函数。如果你两套数据库都支持这里就得区分处理。我的做法是写两个版本的查询函数通过配置文件的db_type字段判断走哪条分支。4. 环境配置、运行与打包全流程4.1 Python环境与PyQt5安装避坑拿到源码后第一步是准备环境。Python版本建议用3.8到3.10之间太高或太低都可能遇到PyQt5的兼容性问题。装Python的时候记得勾选“Add Python to PATH”不然后续命令行操作会找不到Python。安装PyQt5用pip是最省事的pip install PyQt5 PyQt5-tools如果你是在国内网络环境下安装强烈建议先切换镜像源不然可能卡在下载阶段耗掉半小时pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simplePyQt5-tools这个包在最新版本里已经不再单独维护了如果你只需要基础控件装PyQt5就够。装完之后测试一下能否正确导入。4.2 如何初始化数据库并跑通项目项目拿到手先别急着双击main.py先把数据库初始化好不然程序会报“no such table”之类的错误。如果你的项目默认使用SQLite那么数据库文件会在首次连接时自动创建但数据表需要手动导入SQL脚本。最简单的办法是进入Python交互环境执行如下命令sqlite3 student.db .read student.sql .quit或者直接写一段Python脚本来初始化读取SQL文件内容用QSqlQuery逐条执行。我用过之后觉得写一个独立init_db.py脚本是最方便的方案后续重装环境时执行一遍就行。如果你的项目配置成MySQL那流程是在Navicat里新建一个数据库然后右键“运行SQL文件”把建表语句导入再把用户表和初始admin账号的INSERT语句一起执行。完成后检查一下db_config配置文件里的host、port、user、password是否和你本地环境一致。注意MySQL和SQLite的驱动在PyQt5里的写法不一样MySQL用QPSQL或QODBCSQLite用QSQLITE。如果你的项目里数据库连接写得比较复杂优先用SQLite模式跑通。一切就绪后在项目根目录运行python main.py看到登录窗口弹出来说明环境基本正常。4.3 PyInstaller打包成exe的注意事项答辩时能现场双击一个exe直接把系统跑起来印象分会提升不少。打包用PyInstaller是最常规的做法但这块也是坑最多的环节。基础命令很简单pip install pyinstaller pyinstaller -w -F main.py-w表示运行时不显示黑色控制台窗口-F表示打包成单个exe文件。但直接这样打包往往会遇到两个问题第一个是“No module named ‘PyQt5’”。这通常是因为打包环境下PyQt5的某些动态链接库没有被正确识别。解决办法是加--hidden-import参数比如--hidden-importPyQt5.sip。还有一个玄学但很实用的办法确保当前Python环境里只装了PyQt5不要同时装了PySide6二者共存会把打包过程彻底搞乱。第二个是exe的图标路径问题。打包后的exe在运行时如果程序里写了静态相对路径读取ui文件或图标很可能会因为当前工作目录变化而找不到文件。我的经验是在代码开头加上路径自动切换逻辑用os.path.dirname(sys.executable)确定当前exe所在目录然后把所有资源文件都放进去。数据库文件也建议放在exe同目录下程序连接数据库时用动态获取到的路径拼接这样换电脑时把整个文件夹拷走就能用。5. 常见问题与排查技巧实录5.1 运行时报错与界面显示问题我自己在边写边测的时候遇到过不少让人想摔键盘的报错整理几个高频的出来对号入座就能解决。排列第一的是“ModuleNotFoundError: No module named ‘PyQt5’”。原因基本都是当前Python解释器环境不对或者PyQt5没装。排查方式是在命令行执行pip list | findstr PyQt5确认到底装没装如果装了还报错那大概率是IDE里选择的解释器和命令行不是同一个。切换解释器到同一个虚拟环境就能解决。第二个高频问题是界面中文全部乱码。解决办法是在程序入口设置全局字体from PyQt5.QtGui import QFont app.setFont(QFont(Microsoft YaHei, 10))第三个是表格数据显示不完整或者总是显示上一次查询的残留数据。这种情况一般是QSqlQueryModel没有在重新查询前调用clear()。清掉旧模型再重新setQuery刷新就会干净很多。5.2 数据库连接与脚本执行问题在SQLite模式下最常见的报错是“database is locked”。出现这个问题的场景通常是程序还开着你又用外部工具比如SQLiteStudio打开了同一个数据库文件。桌面系统一般不会开多线程写库所以锁库基本是外部工具抢占了。把外部工具关掉程序重启就好。如果是MySQL模式下连接报错最容易忽视的是端口号。MySQL默认3306但如果你本地装了多个数据库实例端口可能被改掉了。先检查db_config里的端口号是否能对得上实际环境。还有一种情况是MySQL 8.0的密码加密方式改了老代码用的驱动连不上解决办法是安装mysql-connector或更新驱动版本。至于表格操作时提示“no such column”这类错误别怀疑不是代码的锅是SQL脚本没执行成功。重新检查一遍建表语句是否完整执行用SELECT * FROM 表名在数据库客户端里跑一遍确认字段存在。5.3 如何在毕设答辩中给项目加分最后分享一个答辩层面的经验。很多学生的毕设代码本身没问题但讲解时只会演示功能不会讲设计导致答辩得分偏低。我建议你在答辩前为这个项目准备三条回答思路第一谈到技术选型时讲清楚为什么选PyQt5而不是Web前端落脚点是“桌面端应用更适用于本地管理、数据不依赖网络、响应速度快”。第二谈到数据库设计时讲清楚三张表之间的关联关系以及为什么成绩表不冗余学生姓名。第三谈到系统安全时讲清楚密码加密和参数化查询的用意哪怕这个系统很小但工程规范是一脉相承的道理。如果答辩时间有富余你可以现场演示修改pyqt5界面上某个按钮的文字或颜色然后重新运行程序说明这个项目的“可维护性”。这个动作很加分因为证明这个项目的界面和逻辑是解耦的改动界面不会伤到业务。等这套基础代码彻底看明白后想再提升可以在学生信息管理之上加“课程成绩统计图”或者“导出Excel成绩单”的功能前者用QtCharts画柱状图后者用第三方库openpyxl生成.xlsx文件。工作量不大但论文的创新点就出来了。本文还有配套的精品资源点击获取