C++ Qt 学生信息管理系统实战：MySQL 驱动配置与增删改查实现

简介：这是一套面向高校计算机相关专业学生与初学者的C++ Qt数据库课程设计/毕业设计参考项目，以MySQL为后台数据库，实现学生信息管理系统。项目覆盖学生、课程、成绩、宿舍、费用、奖励等管理模块，适合正在准备课程设计或想练习Qt界面与数据库交互的开发者。压缩包共79个文件，约211KB，其中26个cpp与25个h构成业务逻辑与类定义，23个ui为Qt Designer界面文件，另有pro工程文件、sql建库脚本、说明文档与运行日志，结构完整、便于直接编译学习。资源已有310人学习下载，可帮助读者快速理解Qt信号槽、界面布局与MySQL增删改查的整合方式，并参考其模块划分与数据库表设计，完成自己的课程设计或二次开发。

1. 从一份能跑通的 C++ Qt 学生管理系统说起

很多同学做毕业设计或课程设计时，卡住的地方往往不是“不会写代码”，而是“不知道一个完整的管理系统到底该长什么样”。这份 C++ Qt 基于 MySQL 的学生信息管理系统，恰好就是一个能直接跑起来的完整参考。它用 Qt 做界面，用 MySQL 存数据，覆盖了学生、课程、成绩、宿舍、缴费、奖励等多个模块，源码、SQL 脚本、说明文档一应俱全。如果你正在找一份结构清晰、模块齐全、能编译能运行的 C++ 课程设计或毕业设计参考，这份资源值得你花时间拆一遍。它适合已经学过 C++ 基础、想通过一个真实项目把 Qt 和数据库串起来的人，也适合需要快速搭出管理系统骨架的开发者。

2. 拆开压缩包：模块划分与数据库表结构怎么对应

拿到压缩包后，先别急着打开 Qt Creator 编译。花十分钟把目录结构和 SQL 文件过一遍，后面能省下大量“编译过了但功能对不上”的返工时间。这个项目的组织方式很典型：每个业务模块基本对应一组.h/.cpp/.ui文件，数据库脚本单独放在studentmanager.sql里。

2.1 从文件名反推功能模块

把文件按前缀归类，能很快看出系统边界：

这种“一个模块一组文件”的做法在课程设计里很常见，好处是职责清晰，坏处是文件数量多，编译时容易漏加。studenntManger.pro是 qmake 的工程文件，里面列出了所有参与编译的源文件和头文件，如果自己新建工程往里搬代码，务必对照这个文件检查有没有遗漏。

2.2 数据库表与代码的映射关系

studentmanager.sql是整个系统的数据底座。导入之前，先确认它建了哪些表、字段类型是否和代码里的 SQL 语句一致。常见做法是：用 MySQL 命令行或 Workbench 打开这个脚本，逐条看CREATE TABLE语句。

-- 示例：学生信息表结构（以实际 SQL 文件为准） CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, gender VARCHAR(10), class_id INT, dorm_id INT, fee_status INT DEFAULT 0 );

上面这段是示意，实际字段名和数量以studentmanager.sql为准。重点看三件事：主键是否自增、外键有没有约束、默认值是否和界面上的初始状态匹配。比如缴费状态如果默认值设成NULL，而代码里判断的是0，那查询就会出问题。globle.h和globle.cpp里通常放着数据库连接信息，包括主机、端口、用户名、密码、库名，导入 SQL 之后要同步改这里。

提示：导入 SQL 前先建一个空库，比如student_manager，字符集选utf8mb4，避免中文姓名或课程名出现乱码。

3. 环境搭建与工程编译：Qt 版本、MySQL 驱动、qmake 配置

这个项目能不能跑起来，八成取决于环境对不对。Qt 和 MySQL 的版本组合、驱动加载方式、编译器套件，任何一个不匹配都会报错。下面按实际操作的顺序走一遍。

3.1 Qt 与 MySQL 的版本选择

项目用的是 qmake 工程（.pro文件），不是 CMake，所以 Qt 5 和 Qt 6 都能打开，但建议优先用 Qt 5.14 或 Qt 5.15。原因很简单：Qt 6 对某些旧版 MySQL 驱动的兼容性不如 Qt 5 稳定，而且网上大量 Qt + MySQL 的教程都是基于 Qt 5 的。MySQL 方面，5.7 和 8.0 都可以，但 8.0 的默认认证插件是caching_sha2_password，老版 Qt 驱动可能连不上，需要改成mysql_native_password。

# 查看 MySQL 用户认证插件 SELECT user, host, plugin FROM mysql.user; # 如果 plugin 是 caching_sha2_password，改成 mysql_native_password ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码'; FLUSH PRIVILEGES;

这段 SQL 的作用是让 MySQL 用户使用旧版认证方式，避免 Qt 的QMYSQL驱动握手失败。改完之后重启 MySQL 服务，再用 Qt 连接测试。

3.2 编译 MySQL 驱动或确认驱动可用

Qt 默认不一定带 MySQL 驱动。打开 Qt Creator，新建一个控制台测试程序，只写数据库连接代码，看能不能加载QMYSQL。

// 测试 QMYSQL 驱动是否可用 #include <QCoreApplication> #include <QSqlDatabase> #include <QSqlError> #include <QDebug> int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); qDebug() << "可用驱动：" << QSqlDatabase::drivers(); QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); db.setHostName("127.0.0.1"); db.setPort(3306); db.setDatabaseName("student_manager"); db.setUserName("root"); db.setPassword("你的密码"); if (!db.open()) { qDebug() << "连接失败：" << db.lastError().text(); } else { qDebug() << "连接成功"; } return a.exec(); }

如果输出里没有QMYSQL，说明驱动没编译或没放到插件目录。常见做法是找到 Qt 安装目录下的plugins/sqldrivers，看有没有qsqlmysql.dll（Windows）或libqsqlmysql.so（Linux）。没有的话，用 Qt 提供的mysql.pro重新编译驱动，编译时需要指定 MySQL 的头文件和库路径。

3.3 用 qmake 构建并解决常见链接错误

回到项目本身，用 Qt Creator 打开studenntManger.pro，选择套件后先执行qmake，再构建。如果报cannot find -lpublic或类似的库缺失，检查.pro文件里的LIBS行，看是否引用了本机不存在的路径。

# .pro 文件中与数据库相关的典型配置 QT += core gui sql greaterThan(QT_MAJOR_VERSION, 4): QT += widgets # 如果手动指定 MySQL 库路径，按实际安装位置改 # LIBS += -L"C:/Program Files/MySQL/MySQL Server 8.0/lib" -llibmysql # INCLUDEPATH += "C:/Program Files/MySQL/MySQL Server 8.0/include"

QT += sql是必须的，没有这行编译时找不到QSqlDatabase。如果用的是 MSVC 套件，还要确保 MySQL 的lib目录在系统PATH里，或者用LIBS显式指定。MinGW 套件则要注意.dll文件是否放到了可执行文件同级目录。

注意：编译前把构建目录清空一次，避免旧的moc文件干扰。尤其是从别人机器上拷来的项目，.pro.user文件里的套件路径很可能对不上，删掉让它重新生成。

4. 核心功能实现：登录验证、学生信息增删改查、成绩与缴费联动

环境通了之后，重点看代码怎么把界面操作翻译成 SQL。这个项目的业务逻辑集中在各个模块的.cpp文件里，套路基本一致：界面收集输入 → 拼接 SQL → 执行 → 刷新表格或弹窗提示。

4.1 登录模块的验证逻辑与 SQL 注入边界

userlogin.cpp负责登录验证。典型写法是拿用户名和密码去user表里查，查到就进主窗口，查不到就提示错误。

// userlogin.cpp 中登录验证的典型逻辑 void userlogin::on_loginButton_clicked() { QString username = ui->usernameEdit->text().trimmed(); QString password = ui->passwordEdit->text().trimmed(); QSqlQuery query; query.prepare("SELECT * FROM user WHERE username = :name AND password = :pwd"); query.bindValue(":name", username); query.bindValue(":pwd", password); if (query.exec() && query.next()) { // 登录成功，打开主窗口 mainwindow *w = new mainwindow(); w->show(); this->close(); } else { QMessageBox::warning(this, "登录失败", "用户名或密码错误"); } }

这里用了prepare和bindValue，是防止 SQL 注入的正确做法。如果换成字符串拼接，输入' OR '1'='1就能绕过验证。参数说明：:name和:pwd是占位符，bindValue会把用户输入当作纯文本处理，不会解析成 SQL 语法。query.next()判断是否有结果行，有就说明账号密码匹配。

4.2 学生信息模块的增删改查实现

stuinformanage.cpp和allstuinform.cpp负责学生信息的录入、修改、删除和展示。以插入为例，界面上的每个输入框对应表里的一个字段。

// 插入学生信息的典型流程 void stuinformanage::on_addButton_clicked() { QString name = ui->nameEdit->text(); QString gender = ui->genderCombo->currentText(); QString classId = ui->classEdit->text(); if (name.isEmpty() || classId.isEmpty()) { QMessageBox::warning(this, "提示", "姓名和班级不能为空"); return; } QSqlQuery query; query.prepare("INSERT INTO student (name, gender, class_id) VALUES (:name, :gender, :class_id)"); query.bindValue(":name", name); query.bindValue(":gender", gender); query.bindValue(":class_id", classId); if (query.exec()) { QMessageBox::information(this, "成功", "学生信息已添加"); // 刷新表格显示 loadStudentTable(); } else { QMessageBox::critical(this, "失败", query.lastError().text()); } }

逻辑说明：先做非空校验，避免插入脏数据；然后用prepare绑定参数；执行成功后调用刷新函数重新查表。参数方面，class_id如果表里设了外键约束，插入前要确保班级表里存在对应的id，否则会报外键错误。删除操作通常用DELETE FROM student WHERE id = :id，修改用UPDATE student SET ... WHERE id = :id，套路相同。

4.3 成绩、缴费、奖励模块的数据联动

成绩模块scoremanage.cpp和缴费模块feemanage.cpp往往不是孤立的。比如缴费状态可能影响成绩查询权限，或者奖励信息关联学生 ID。看代码时重点找JOIN语句。

// 查询学生成绩并关联学生姓名 QSqlQuery query; query.prepare("SELECT s.name, c.course_name, sc.score " "FROM score sc " "JOIN student s ON sc.student_id = s.id " "JOIN course c ON sc.course_id = c.id " "WHERE s.class_id = :class_id"); query.bindValue(":class_id", classId); query.exec();

这种多表关联在成绩查询、宿舍分配、奖励发放里都会出现。参数:class_id用来筛选某个班级。如果查询结果为空，先检查三张表里的关联字段是否都有对应数据，再检查JOIN条件有没有写错字段名。常见坑是student_id和id类型不一致，一个是INT一个是VARCHAR，MySQL 会做隐式转换但可能不走索引。

提示：所有涉及金额或成绩的字段，建议在数据库里用DECIMAL而不是FLOAT，避免浮点误差导致缴费金额对不上。

5. 避坑与排查：驱动加载失败、中文乱码、界面卡死

这一章记录的是实际跑这个项目时最容易翻车的地方。每条都按“现象 → 原因 → 解决”写，遇到问题可以直接对照。

5.1 QMYSQL 驱动加载失败

现象：程序启动后连接数据库，报QSqlDatabase: QMYSQL driver not loaded，或者available drivers列表里没有QMYSQL。

原因：Qt 安装时没有自带 MySQL 驱动，或者驱动版本和当前 Qt 套件不匹配。Windows 上还可能是libmysql.dll没放到可执行文件目录。

解决：先确认plugins/sqldrivers下有没有qsqlmysql.dll。没有就用 Qt 源码里的mysql.pro编译一个，编译时INCLUDEPATH指向 MySQL 的include，LIBS指向lib。编译出的qsqlmysql.dll放到sqldrivers目录，libmysql.dll放到exe同级目录。Linux 下对应.so文件，用ldd检查依赖是否齐全。

5.2 中文乱码

现象：界面上显示的学生姓名、课程名变成问号或方块，或者数据库里存进去的中文读出来是乱码。

原因：数据库、表、连接三处的字符集不一致。常见的是数据库建库时用了latin1，而 Qt 这边按UTF-8发送。

解决：建库时指定CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci。连接建立后立即执行SET NAMES utf8mb4。Qt 代码里用QString::fromUtf8和toUtf8处理字符串。如果已经建了库，用ALTER DATABASE和ALTER TABLE改字符集。

ALTER DATABASE student_manager CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

5.3 界面卡死或无响应

现象：点击查询按钮后界面卡住，过几秒才恢复，数据量大时直接无响应。

原因：数据库查询在主线程（UI 线程）里同步执行，查询耗时长了就会阻塞界面刷新。

解决：小数据量下可以接受，但如果表里数据多，建议把查询放到QThread或QtConcurrent::run里，查完再通过信号槽把结果传回主线程更新界面。课程设计级别不强制，但要知道这个边界。另一个简单做法是给查询加LIMIT，避免一次性拉全表。

5.4 编译时报 “cannot find -lpublic” 或类似库缺失

现象：链接阶段报错，提示找不到某个库。

原因：.pro文件里LIBS引用了本机不存在的路径，或者库文件名写错。

解决：打开.pro文件，把LIBS行注释掉，只保留QT += sql，让 Qt 自己找驱动。如果必须手动指定，确认路径下的库文件确实存在，Windows 下是.lib，Linux 下是.so。MinGW 和 MSVC 的库不通用，套件选了什么就用对应的库。

5.5 主窗口关闭后程序仍在后台

现象：关闭主窗口后，任务管理器里进程还在。

原因：登录窗口和主窗口之间用new创建，没有设置Qt::WA_DeleteOnClose，或者main.cpp里return a.exec()之前有窗口没关。

解决：在创建主窗口时设置w->setAttribute(Qt::WA_DeleteOnClose);，或者在main.cpp里用QApplication::setQuitOnLastWindowClosed(true)（默认就是 true，但如果有隐藏窗口就不生效）。检查登录窗口关闭时是否只hide()而没有close()。

6. 进阶用法：把这份代码改成你自己的毕业设计

直接交一份别人的代码风险很大，查重和答辩都过不去。更合理的做法是把它当成骨架，替换业务字段、调整界面布局、增加一两个有区分度的功能。下面说几个我常用的改造方向。

6.1 替换业务字段与表结构

先确定你的题目需要哪些实体。比如“实验室设备管理系统”，就把student表改成device表，字段从姓名、性别、班级换成设备名、型号、采购日期。对应的.cpp文件里 SQL 语句和界面标签同步改。改的时候用全局搜索替换，但注意student_id这种外键字段名不要漏改，否则JOIN会断。

-- 把学生表改造成设备表的示例 RENAME TABLE student TO device; ALTER TABLE device CHANGE name device_name VARCHAR(100); ALTER TABLE device CHANGE class_id lab_id INT; ALTER TABLE device ADD COLUMN purchase_date DATE;

改完表结构后，把globle.h里的表名宏定义也改掉，避免硬编码散落各处。

6.2 增加一个统计图表模块

答辩时有个图表会加分不少。Qt 自带QtCharts模块，可以在主窗口加一个“统计”按钮，点击后弹出一个窗口，用柱状图显示各班级人数或各课程平均分。

// 使用 QtCharts 画一个简单柱状图 #include <QtCharts/QChartView> #include <QtCharts/QBarSeries> #include <QtCharts/QBarSet> #include <QtCharts/QBarCategoryAxis> void statisticWindow::showChart() { QBarSet *set = new QBarSet("人数"); *set << 30 << 25 << 28 << 22; // 各班级人数，实际从数据库查 QBarSeries *series = new QBarSeries(); series->append(set); QChart *chart = new QChart(); chart->addSeries(series); chart->setTitle("各班级人数统计"); QStringList categories; categories << "一班" << "二班" << "三班" << "四班"; QBarCategoryAxis *axisX = new QBarCategoryAxis(); axisX->append(categories); chart->addAxis(axisX, Qt::AlignBottom); series->attachAxis(axisX); QChartView *view = new QChartView(chart); view->setRenderHint(QPainter::Antialiasing); view->resize(600, 400); view->show(); }

这段代码的关键是QBarSet存数据、QBarSeries做系列、QChart管标题和坐标轴。数据不要写死，从数据库SELECT class_id, COUNT(*) FROM student GROUP BY class_id查出来再填进去。.pro文件里要加QT += charts。

6.3 用事务保证多表操作一致性

删除一个学生时，如果他的成绩、缴费、奖励记录还留在其他表里，就会产生孤儿数据。正确做法是用事务包起来。

QSqlDatabase::database().transaction(); QSqlQuery query; query.prepare("DELETE FROM score WHERE student_id = :id"); query.bindValue(":id", studentId); bool ok1 = query.exec(); query.prepare("DELETE FROM fee WHERE student_id = :id"); query.bindValue(":id", studentId); bool ok2 = query.exec(); query.prepare("DELETE FROM student WHERE id = :id"); query.bindValue(":id", studentId); bool ok3 = query.exec(); if (ok1 && ok2 && ok3) { QSqlDatabase::database().commit(); } else { QSqlDatabase::database().rollback(); QMessageBox::critical(this, "错误", "删除失败，已回滚"); }

事务的好处是：任何一步失败，前面的删除都会撤销，不会留下半截数据。参数:id是学生主键，三张表都用同一个值。注意 MySQL 的 InnoDB 引擎才支持事务，MyISAM 不支持，建表时确认引擎类型。

6.4 打包发布时带上 MySQL 依赖

最后交作品时，不能要求老师电脑上装 Qt 和 MySQL。用windeployqt把 Qt 依赖拷出来，再把libmysql.dll和sqldrivers目录一起放进去。数据库可以用 SQL 脚本在目标机器上先导入，或者改用 SQLite 做单机演示版，把QMYSQL换成QSQLITE，连接字符串改成文件路径即可。SQLite 不需要额外安装服务，适合答辩现场演示。

// 切换到 SQLite 做单机演示 QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); db.setDatabaseName("student_manager.db");

改完之后，所有 SQL 语句基本不用动，但要注意 SQLite 不支持RIGHT JOIN和某些 MySQL 函数，遇到报错就改成子查询或分步查询。

从那以后我每次拿到别人的课程设计代码，都先跑通数据库连接再动界面，不然改了半天发现驱动没加载，时间全白费。希望帮到你。

本文还有配套的精品资源，点击获取