简介这份C Qt结合MySQL的学生信息管理系统源码包面向需要完成课程设计或毕业设计的计算机相关专业学生也适合初学者学习Qt界面开发与数据库联动编程。包内包含完整可编译的工程文件涵盖学生信息、课程、成绩、宿舍、奖惩、缴费等模块通过登录验证、增删改查、模糊查询等操作演示了Qt Widgets与MySQL数据库的典型交互方式。资源共79个文件以26个cpp、25个h源文件为主附带23个ui界面设计文件和SQL建库脚本可直接导入项目并对照学号修改数据库连接配置适合作为功能演示、二次开发或答辩讲解的基础。压缩包仅211KB轻量易部署目前已有312人学习下载。对于希望快速理清多模块管理系统代码结构、掌握QTableView、QSqlQuery等常见类用法的读者这份资料具备较高的参考价值能帮助缩短项目开发周期并理解实际业务场景下的数据管理流程。1. Qt MySQL 学生信息管理系统一份能跑通的课设源码包期末前两周接到课程设计题目“学生信息管理系统”要求用 MySQL 做数据层、带图形界面完成增删改查。网上找的模板不是缺文件就是编译不过最后拿到这份 C Qt MySQL 源码包从导入 studentmanager.sql 到 Qt Creator 编译出主窗口一个晚上跑通。系统覆盖学生、课程、成绩、宿舍、奖励、缴费六个业务模块登录区分普通用户和管理员正好覆盖 MySQL 毕业设计和课程设计最常见的功能要求。zip 里还带了一份使用说明和报告 docx写文档时能省不少事。适合正在做课设、或者第一次用 Qt Widgets 接 MySQL 的开发者参考复现。2. 工程全景把六十多个文件拆成八个功能模块2.1 文件清单读法界面、逻辑、入口各在哪拿到 zip 后别急着点开 pro 就编译先花十分钟把文件清单过一遍。这套工程里.ui文件是 Qt Designer 画的界面.h/.cpp是对应窗口的业务逻辑globle.h/globle.cpp是全局函数和公共变量student.h是实体类main.cpp是程序入口studentmanager.sql是建库脚本。还有一个OGLdpf.log那是之前某次运行的遗留日志不是工程必需文件可以忽略。按功能模块对一下文件结构非常清晰模块主要文件负责内容学生信息stuinformanage.cpp、allstuinform.cpp、studentform.cpp、seeallstuinfor.cpp学生档案增删改查、列表浏览课程管理coursemanage.cpp、coursefind.cpp课程信息维护、按条件筛选成绩管理scoremanage.cpp、findscore.cpp成绩录入、按学号或课程查询宿舍管理dormmanage.cpp、dormfind.cpp、seedorminfor.cpp宿舍分配、入住信息查询奖励管理awardmanage.cpp、awardfind.cpp奖励记录登记与查询缴费管理feemanage.cpp、moneyfind.cpp学费杂费记录维护班级管理classmanage.cpp、findclass.cpp班级列表维护登录与权限userlogin、insertlogin、updatelogin、deletelogin登录验证、用户管理注意文件名seedorminfor是 “See Dorm Infor” 的缩写功能是查询宿舍信息。这套命名习惯很课设风功能词加 manage/find 结尾manage 表示维护界面find 表示查询界面。后面改代码时看到 find 开头的窗口基本就是只读查询。2.2 登录、主框架和全局变量的分工工程入口是先起 userlogin 还是先起 mainwindow从 main.cpp 里能看到。常见做法是先创建登录窗口用exec()阻塞运行登录成功后再 show 主窗口。这样主窗口的构造和数据库连接都可以放在登录成功之后避免没连上库就先弹出空界面。mainwindow.ui 是主框架左右或顶部放功能菜单中间用 QStackedWidget 切换各个业务窗口。manger.ui 对应的是管理员专属界面普通用户登录后只能进部分界面权限控制通常体现在按钮的setEnabled或窗口的 show 条件里。globle.h里一般放着全局的数据库连接变量和当前登录用户信息所有业务窗口通过 include globle.h 共用同一个 QSqlDatabase 实例。这里要留意全局连接最好是单例化在 globle.cpp 里定义一次其它窗口只引用不重复创建否则每个窗口都addDatabase一次连接名冲突会直接报错。2.3 为什么是 Qt Widgets MySQL这套技术栈在课设场景里比 Web 方案省心。Qt Widgets 是 C 桌面开发的成熟方案控件拖拽出来就是原生窗口不需要额外起前端服务MySQL 是几乎所有机器上都装过的开源数据库题目要求里也常直接指定。和 Python PyQt 比C 的编译产物是独立 exe交作业演示时不用现场配 Python 环境和 WPF 比Qt 跨平台Windows 和 Linux 上都有一致的 pro 工程结构。这套工程用的是 QSqlDatabase QSqlQuery 这套 Qt SQL 模块而不是直接在 C 里调 MySQL C API。原因是前者把连接管理、预处理、错误信息都封装好了出错时lastError().text()能直接给出可读信息排查问题效率高得多。代价是依赖 Qt 自带的数据库驱动插件这事在编译时最容易翻车第四章会专门说。3. 数据库先行studentmanager.sql 怎么导入、表怎么设计3.1 表结构逻辑业务表之间的关联关系先看 sql 脚本里建了哪些表。以课设常见设计来说studentmanager.sql 里一般会包含 user、student、course、score、dorm、award、fee、class_info 这些表。学生表存基本信息班级表管班级编号和专业课程表和成绩表通过 student_id、course_id 关联宿舍表用 student_no 记录入住情况奖励表和缴费表再各自挂 student_id。这样的关联设计符合第三范式也方便后面写 JOIN 查询统计。学生表常见结构长这样CREATE TABLE student ( id int(11) NOT NULL AUTO_INCREMENT COMMENT 自增主键, student_no varchar(20) NOT NULL COMMENT 学号唯一, name varchar(50) NOT NULL COMMENT 姓名, gender varchar(4) DEFAULT NULL COMMENT 性别, class_id int(11) DEFAULT NULL COMMENT 班级id关联class_info, phone varchar(20) DEFAULT NULL COMMENT 手机号, remark varchar(255) DEFAULT NULL COMMENT 备注, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生信息表;关键点是学号要建 UNIQUE KEY否则同一个人被录入两次也发现不了class_id 留成普通索引列方便 JOIN 班级表时走索引。主键用 AUTO_INCREMENT 而不是直接用学号做主键是因为学号一旦录错要改时主键变更会牵动成绩、缴费等所有子表的外键。成绩表通常是多对多的关系表score 表里至少有三个字段student_id、course_id、score。这里建议再加一个 UNIQUE KEY(student_id, course_id)保证同一个人对同一门课只有一条成绩记录。登录表 user 单独建username 唯一password 建议不存明文课设里虽然直接存明文也能跑但报告里提一句“生产环境需要加盐哈希”能加分。3.2 导入步骤命令行和图形客户端两条路拿到 studentmanager.sql 之后先确认 MySQL 服务是起的。Windows 上可以用命令行导入mysql -u root -p -h 127.0.0.1 -P 3306输入密码后进入交互模式再执行source D:/path/to/studentmanager.sql;-h指定主机本机连 127.0.0.1-P大写指定端口默认 3306 可以省略source 后面是 sql 文件的绝对路径路径别用反斜杠命令行里写D:/path这种正斜杠最稳。如果嫌命令行麻烦图形客户端里右键连接 → 运行 SQL 文件也可以但导入完成后要记得刷新连接否则表列表不更新容易误以为导入失败。导入完先验证别急着开 Qt 工程USE studentmanager; SHOW TABLES; SELECT COUNT(*) FROM student;能列出表和记录数说明脚本执行成功。这里特别提一句SHOW TABLES 看不到表时先看是不是选到了别的库很多新手会把脚本导进默认库而不是 studentmanager 库。3.3 字符集和存储引擎utf8mb4 与 InnoDB 不要动建表脚本里反复出现的两个关键词是 utf8mb4 和 InnoDB。utf8mb4 是 utf8 的超集能存 emoji 和生僻字现在建库默认都用它。注意连接字符串里也要指定只建表时写了 utf8mb4 而连接用默认 latin1中文照样乱码。InnoDB 提供行级锁、外键和事务成绩表、缴费表这类需要保证一致性的场景必须用它。如果脚本里建的是 MyISAM建议手动改成 InnoDB否则并发写成绩时容易锁表。导入完成后打开使用说明 docx里面一般会写默认数据库名和账号密码。如果文档里没写那就按工程里 globle.cpp 或连接代码里出现的库名、账号为准这两个地方是项目的“数据库配置真相”。4. 编译与连接pro 文件、MySQL 驱动和登录验证的落地方案4.1 pro 文件QT sql 漏掉等于白搭Qt Creator 打开根目录的 pro 文件后第一件事看QT这一行。默认新建工程是QT core gui但这个工程要用数据库必须加 sql 模块。如果文件列表里的 pro 没写全手动补上QT core gui sql greaterThan(QT_MAJOR_VERSION, 4): QT widgets TEMPLATE app TARGET StudentManager SOURCES \ main.cpp \ mainwindow.cpp \ userlogin.cpp \ stuinformanage.cpp \ coursefind.cpp \ scoremanage.cpp HEADERS \ mainwindow.h \ userlogin.h \ globle.h \ student.h FORMS \ mainwindow.ui \ userlogin.ui \ stuinformanage.ui上面是精简示例真实工程要把文件列表里所有 .cpp/.h/.ui 按目录结构列全。注意greaterThan(QT_MAJOR_VERSION, 4)是兼容 Qt5/Qt6 的写法Qt6 里可以直接写QT widgets。pro 文件改动后要右键工程标签页选执行 qmake再重新构建。跳过这步会出现“找不到 ui_mainwindow.h”之类的玄学报错实际就是 Makefile 没按新配置重新生成。4.2 数据库连接QMYSQL 驱动和它的脾气连接库的代码通常集中在 globle.cpp 或某个登录窗口里。标准写法是#include QSqlDatabase #include QSqlQuery #include QSqlError #include QDebug bool initDb() { QSqlDatabase db QSqlDatabase::addDatabase(QMYSQL); db.setHostName(127.0.0.1); // 本机连接 db.setPort(3306); // MySQL 默认端口 db.setDatabaseName(studentmanager); // 库名要和 sql 脚本一致 db.setUserName(root); db.setPassword(123456); // 改成你本机的密码 if (!db.open()) { qDebug() 数据库连接失败: db.lastError().text(); return false; } return true; }addDatabase的第一个参数是驱动名QMYSQL 是 Qt 官方 MySQL 驱动。setHostName可以是 IP 或域名setPort不写会走驱动默认 3306但建议显式写出来方便排查端口占用setDatabaseName必须和 studentmanager.sql 里 USE 的库名一致账号密码按本机环境改。连接是同步阻塞的连接慢时界面会卡一下课设项目不用处理报告里能指出这个改进点反而是加分项。如果在运行时报QSqlDatabase: QMYSQL driver not loaded最省事的兜底方案是改走 ODBCQSqlDatabase db QSqlDatabase::addDatabase(QODBC); db.setDatabaseName(Driver{MySQL ODBC 8.0 Unicode Driver}; Server127.0.0.1;Port3306; Databasestudentmanager;); db.setUserName(root); db.setPassword(123456);ODBC 连接串里Driver必须写你机器上实际装的驱动名装的是 5.3 就写 5.3。这个方案能绕开 Qt 自带 MySQL 插件版本不匹配的问题代价是依赖系统 ODBC 配置交作业的机器上如果没装对应驱动照样连不上。4.3 登录验证与首屏查询从 userlogin.cpp 看安全性细节userlogin.cpp 里做的核心事情是取输入框文本 → 查 user 表 → 判断返回值。最省事但最不该用的写法是字符串拼接QString sql QString(SELECT * FROM user WHERE username%1 AND password%2) .arg(usernameEdit-text(), passwordEdit-text()); QSqlQuery query; query.exec(sql);这段在单机课设里能跑但用户输入 OR 11就能绕过密码。改用预处理参数绑定QSqlQuery query; query.prepare(SELECT role FROM user WHERE username ? AND password ?); query.addBindValue(usernameEdit-text().trimmed()); query.addBindValue(passwordEdit-text().trimmed()); if (!query.exec()) { qDebug() 查询失败: query.lastError().text(); return; } if (query.next()) { QString role query.value(0).toString(); // role 为 admin 进管理员界面否则进普通界面 } else { QMessageBox::warning(this, 登录失败, 用户名或密码错误); }prepare加addBindValue会把参数作为整体传给 MySQL注入字符不会参与 SQL 解析。注意用户名做了trimmed()密码没做因为密码里的空格可能是有效字符。登录成功后把 role 存进全局变量后续窗口根据 role 决定按钮显隐。首屏查询常见做法是主窗口 show 后就跑一次全表查询用 QSqlQueryModel 绑到 QTableView 上。这里有个小坑模型和视图都要在窗口类的成员变量里持有不要用局部变量否则数据刷不出来。绑定方式QSqlQueryModel *model new QSqlQueryModel(this); model-setQuery(SELECT student_no AS 学号, name AS 姓名, phone AS 手机号 FROM student); ui-tableView-setModel(model);setQuery里的 SQL 直接执行并填充模型AS 别名会变成表头文字这是最简单的中文化表头方案比手动 setHeaderData 省事得多。后续按班级过滤、翻页只需要重新 setQuery 再 setModel 刷新。5. 避坑排查编译报错、中文乱码、驱动丢失的血泪经验5.1 编译期moc 缓存和驱动插件现象改了 pro 文件后重新构建报错mainwindow.h: No such file or directory或者提示“class MainWindow has no member named ui”。 原因qmake 没重跑工程仍按旧配置编译。Qt Creator 改了 pro 后不会每次自动执行 qmake必须手动触发。 解决右键工程根节点 → 执行 qmake然后再构建。还不行就先 Clean 再重新构建把 build 目录里的 Makefile 删掉也行。现象编译能过启动时报QSqlDatabase: QMYSQL driver not loaded。 原因Qt 安装目录的plugins/sqldrivers下没有对应编译器的 qsqlmysql 插件。Qt 的 MySQL 驱动插件需要和编译器版本匹配MinGW 版 Qt 配 MSVC 插件就会加载失败也可能 MySQL 版本太新Qt 内置驱动初始化失败。 解决先到Qt安装目录/版本/mingw*/plugins/sqldrivers里确认有没有 qsqlmysql.dll。有但报错检查 PATH 里能不能找到 libmysql.dll没有就直接改 QODBC 方案这是投入产出比最高的路。5.2 运行期乱码、闪退、插不进现象中文存进 MySQL 再查出来全是???但用命令行查表里数据又是正常的。 原因Qt 客户端连接字符集和 MySQL 服务端不一致。常见于服务端character_set_server是 latin1或连接没指定字符集。 解决建表统一 utf8mb4连接后立即执行一次query.exec(SET NAMES utf8mb4)。也可以把?charsetutf8mb4拼进连接串。改完后删除原表重新导入 sql 脚本清掉脏数据。现象在 Qt Creator 里按运行没问题直接双击 build 目录里的 exe 秒退。 原因缺运行时依赖典型是libmysql.dll连接数据库时才加载一加载失败程序就崩。 解决把 MySQL 安装目录里的 libmysql.dll 复制到 exe 同目录。发布时先用 Qt 自带的 windeployqt 把 Qt 的 dll 带出来windeployqt ./StudentManager.exe跑完看输出缺的文件会列出来再把 MySQL 的 dll 单独拷进去。现象新增学生保存时报错或没报错但表格里看不到新数据。 原因SQL 里 INSERT 漏了某个 NOT NULL 字段MySQL 报错被代码吞了或主键不是自增插入时撞了已有主键。 解决先看代码里 exec 之后有没有判错没判错的第一时间补上if (!query.exec()) { qDebug() query.lastError().text(); }然后查表结构确认 id 是 AUTO_INCREMENT。插入时不要显式传 id 字段让数据库自己分配。6. 进阶验证外置配置、只读报表模板与全链路复测6.1 把连接信息外置到 config.ini演示时经常要在不同机器上跑密码写死在代码里换台机器就要重新编译。用 QSettings 把连接参数挪出来改配置不用动代码QSettings settings(config.ini, QSettings::IniFormat); db.setHostName(settings.value(db/host, 127.0.0.1).toString()); db.setPort(settings.value(db/port, 3306).toInt()); db.setDatabaseName(settings.value(db/name, studentmanager).toString()); db.setUserName(settings.value(db/user, root).toString()); db.setPassword(settings.value(db/password, ).toString());config.ini 放在 exe 同目录键名用组/键的结构默认值作为第二个参数。这套方案同样适用于把 odbc 驱动名、报表导出路径都纳进去。6.2 用 QSqlQueryModel 快速套出只读报表课程设计里常要求“按班级统计成绩”与其重写界面不如建一个报表窗口只放 QTableView 加一个统计按钮void ReportWindow::refresh(QString classId) { model-setQuery(QString( SELECT c.class_name, s.student_no, s.name, AVG(sc.score) AS avg_score FROM class_info c JOIN student s ON s.class_id c.id JOIN score sc ON sc.student_id s.id WHERE c.id %1 GROUP BY s.id ORDER BY avg_score DESC) .arg(classId)); ui-tableView-setModel(model); }这里用QString::arg拼 classId 有注入风险严格做法是先查出班级列表再用参数化查询重新 setQuery。课设阶段用这层 JOIN 已经够关键是能把 GROUP BY 和 ORDER BY 的语义讲清楚。6.3 全链路复测五分钟判断资源可用性拿到这套资源后我每次都会按同样顺序验证命令行导入 studentmanager.sql 并 SELECT 确认数据 → 打开 pro 工程右键执行 qmake → 先编译一次确认没有缺失文件 → 单独测试数据库连接把登录窗口跑起来看报错还是进入主界面 → 每个管理窗口各做一次新增、修改、删除、查询 → 再检查一遍中文显示和窗口自适应。四个模块全过一遍差不多就能确认这份资源完整可用。这套工程跑通后把 utf8mb4 字符集、InnoDB 表设计、参数化登录查询这三个点写进报告里答辩被问数据库相关问题时基本能接住。从那以后我拿到任何 Qt 加 MySQL 的源码包都强制先走一遍这个顺序省掉了大量反复编译试错的时间。希望帮到你。本文还有配套的精品资源点击获取