简介面向计算机专业学生与毕业设计开发者的 C 实践项目实现基于 Qt 图形界面框架与 MySQL 数据库的学生信息管理系统。项目覆盖学生信息、课程、班级、成绩管理等核心模块并提供成绩统计、表格导出、重置密码等功能适用于课程设计、毕业设计及 Qt 数据库开发的入门进阶参考。资源包共 105 个文件约 14.75MB包含 C 源文件.cpp/.h用于业务逻辑与数据库交互Qt 界面文件.ui与 PNG 图标完善前端展示SQL 脚本用于初始化数据表另有 .pro 工程文件、说明文档及演示 PPT 等便于理解项目整体结构与运行流程。目前已有 494 人学习下载。资料提供可直接编译的完整源码并附数据库建表脚本、界面设计与项目说明可帮助读者掌握 Qt 控件布局、MySQL 连接与增删改查操作以及系统分层实现思路。对需要完成课设或毕设选题的人而言是一套值得对照学习与二次开发的实践素材。1. 一个能直接跑的 Qt 学生信息管理系统课程设计到毕业设计都能用如果你的 QT 课程设计或毕业设计要做一个数据库系统学生信息管理几乎是最常被点名的题目。这份基于 C、Qt 和 MySQL 的完整工程把界面、业务、数据三层都给你铺好了登录校验、学生信息增删改查、分页展示、按条件搜索SQL 建表脚本也一并打包。适合 C 语法已经入门、但还没正儿八经把 Qt 窗口和 MySQL 连起来的人。直接打开源码研究也好解压改造成自己答辩的项目也好都能省掉大量查资料的时间。接下来我把解压、配置、跑通、排错这条路上最容易被卡住的点逐个说清楚。2. 环境选型与工程结构Qt 版本、MySQL 驱动与解压包布局2.1 为什么是 Qt MySQL课程设计与毕业设计里最常见的选项学生信息管理系统如果用纯控制台写功能也能跑但交上去的视觉观感就是黑框框答辩时很难撑起“界面设计”这一项。用 Qt 做界面按钮、表格、输入框都拖拽可得界面代码和学习成本都不算高数据库选 MySQL则是因为它在“数据库系统”课程里的覆盖率极高老师熟悉、文档多、网上能查到的排错经验也多。相比直接用文本文件或 Excel 存数据MySQL 把查询、去重、事务、并发这些问题都变成了 SQL 语句你不需要在 C 里手写一堆数据结构去维护状态。这套工程给你提供了一个很直接的学习链路Qt 的 QSqlDatabase 负责建立连接QSqlQuery 负责执行 SQLQTableWidget 或 QTableView 负责把结果渲染到界面上。你不需要把这套东西从零发明出来照着工程里的结构走一遍等于同时练了 C 封装、Qt 控件布局、SQL 语句三种能力。对毕设而言这套组合在“系统设计”和“数据库设计”两个章节也有东西可写不会出现“工作量不够”的尴尬。2.2 工具链版本匹配Qt 版本、编译器和 MySQL 客户端库拿到压缩包的第一件事不是双击 .pro 文件而是确认你这台机器上的 Qt 版本和 MySQL 实例能不能兼容。这套管理系统属于典型的 Qt Widgets 应用Qt 5.15.2 LTS 是最稳妥的选择既有长时间维护网上资料也多如果你已经在用 Qt 6.x问题也不大核心 SQL 模块的 API 基本一致。真正的坑在编译器套件和 MySQL 客户端库的位数匹配上。在 Qt Creator 里新建套件时MinGW 版本和 MSVC 版本不能混用如果代码是用 MSVC 编译的运行时却缺了 MSVC 的运行库程序报错会让你完全摸不着头脑。常规做法是保持 Qt 套件、编译器位数、MySQL Connector/C 库完全一致64 位工程配 64 位 MySQL32 位工程配 32 位 MySQL。也要留意如果你本机装的是 MySQL 8.0老版本 Qt 自带的 QMYSQL 插件可能不认识它默认的 caching_sha2_password 认证协议打开连接时直接报 “Authentication plugin caching_sha2_password cannot be loaded”。常见解决办法是回退 MySQL 用户认证方式具体 SQL 我会在避坑章节里写出来。2.3 解压包目录结构源码、SQL 脚本和说明文档怎么看这种打包资源下载下来文件归类一般比较常规。按照我拆过不少工程的经验解压后重点认准三类东西源码目录包含 Qt 工程的 .pro 工程文件、头文件、cpp 源文件以及界面文件。真正的主逻辑都在这里建议先用 Qt Creator 打开 .pro 看一遍编译是否通过。sql 目录一般是一个 .sql 脚本里面是建库、建表、插入初始数据的语句。这个是跑通系统的前置条件数据库不建好程序再正常也连不上。说明文档通常是一个 README 或者运行说明文档写清楚开发环境版本、启动步骤、默认账号密码。拿到资源先读说明能省掉大量瞎猜的时间。打开 .pro 文件后你先看里面有没有QT core gui sql这一行。如果缺了 sql 模块编译时会报“无法包含 QSqlDatabase”等错误如果加了 sql 模块但编译后运行时说驱动找不到那是 Qt 插件目录没有对应驱动文件的问题。我习惯把源码目录和 sql 脚本放在同一个父目录下这样后续调试时路径关系最清晰不会出现莫名其妙的相对路径问题。3. 数据库设计三张核心表与 Qt 侧连接封装3.1 三张核心表的设计学生信息、用户账号与选课成绩学生信息管理系统看着简单表设计得不好后面写功能时会绕很多路。这套项目里最核心的是三个实体用户、学生、成绩。用户表负责登录和权限控制学生表存基本档案成绩表存选课成绩三张表关系清晰也方便你在课程设计报告里画 ER 图。下面这段 SQL 是常见的建表思路你可以直接对比着手里的 sql 脚本CREATE DATABASE IF NOT EXISTS student_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE student_db; CREATE TABLE tb_user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role TINYINT NOT NULL DEFAULT 1 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE tb_student ( sno VARCHAR(20) PRIMARY KEY, name VARCHAR(50) NOT NULL, gender CHAR(2) DEFAULT 男, birth_date DATE, major VARCHAR(50), class_no VARCHAR(30), phone VARCHAR(20) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE tb_score ( id INT AUTO_INCREMENT PRIMARY KEY, sno VARCHAR(20) NOT NULL, course_name VARCHAR(50) NOT NULL, credit DECIMAL(4,1) DEFAULT 0.0, score DECIMAL(5,1) DEFAULT 0.0, UNIQUE KEY uk_sno_course (sno, course_name), CONSTRAINT fk_score_student FOREIGN KEY (sno) REFERENCES tb_student(sno) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里最值得注意的一点是学生表的主键用的是VARCHAR(20)而不是自增INT。原因很实际——很多学校学号就是普通数字串可能有前导 0比如“20230001”如果用整数类型存储前导 0 会被吃掉查询结果跟学籍系统对不上。这个细节在答辩时主动讲出来老师会觉得你考虑到了真实数据场景。成绩表里对(sno, course_name)建联合唯一索引是为了防止同一学生同一门课程重复录入这条约束在实际使用中非常有用。3.2 Qt 连接 MySQL用 QSqlDatabase 写一个连接单例数据库连接最好封装成独立的类不要在每个窗口里到处创建连接。常规做法是写一个数据库管理类提供初始化函数整个程序里只保留一个连接实例。Qt 的QSqlDatabase::addDatabase加上自定义连接名可以避免到处调用时连接被覆盖。#include QSqlDatabase #include QSqlQuery #include QSqlError #include QDebug static QSqlDatabase initDatabase() { QSqlDatabase db QSqlDatabase::addDatabase(QMYSQL); db.setHostName(127.0.0.1); db.setPort(3306); db.setDatabaseName(student_db); db.setUserName(root); db.setPassword(123456); db.setConnectOptions(MYSQL_OPT_RECONNECT1); db.setNumericalPrecisionPolicy(QSql::HighPrecision); if (!db.open()) { qDebug() 数据库打开失败 db.lastError().text(); return QSqlDatabase(); } QSqlQuery query(db); query.exec(SET NAMES utf8mb4); return db; }这段代码里需要留意的参数是setConnectOptions(MYSQL_OPT_RECONNECT1)。它的作用是让连接在 MySQL 服务端主动断开后自动尝试重连避免程序长时间挂在那里后第一次点击查询时报 “Lost connection to MySQL server”。setNumericalPrecisionPolicy(QSql::HighPrecision)则保证 DECIMAL 类型字段在读取时不被拦腰转成 double 而丢精度成绩和学分这类数据尤其需要这个设置。3.3 连接参数说明与常见连接方式对照Qt 连接 MySQL 有两种主流方式一种是上面这种直接用 QMYSQL 驱动另一种是走 ODBC 数据源。两者选型主要看你的 Qt 安装包里有没有带 qsqlmysql.dll 插件。如果你用的 Qt 版本是精简安装缺少这个插件QMYSQL 路径就走不通转用 ODBC 是很多人的备选方案。连接方式驱动名优势常见坑QMYSQLQMYSQL配置简单代码直观驱动插件可能缺失MySQL 8.0 认证协议兼容性差ODBCQODBC适应性好不依赖 Qt 插件Windows ODBC 数据源需要手动配置部署成本高连接失败时先看 Qt 输出的lastError().text()它比你看界面上“连接失败”四个字要有用得多。常见失败原因无非四类驱动插件缺失、MySQL 服务未启动、用户名密码不对、目标库不存在。把错误信息拿出来逐个对照排查通常五分钟内能定位。我一般会在调试阶段把数据库参数放在一个 configure 文件里读取而不是写死在代码里后面替别人部署时就不需要重新编译程序。4. 核心功能落地登录校验、分页查询与增删改查4.1 登录模块用参数绑定防 SQL 注入的正确姿势登录功能是管理系统的门户也最容易出现“能跑但不安全”的写法。初学者最容易犯的错误是把用户名和密码直接拼进 SQL 字符串里比如用 QString 拼接构造一条查询语句这在功能上没问题但只要用户在输入框里输入带单引号的特殊字符串就可能把 SQL 语义改掉。这个资源包里的登录校验如果用的是预处理语句那么思路就是标准的。bool loginUser(const QString username, const QString password) { QSqlQuery query; query.prepare(SELECT id, role FROM tb_user WHERE username :user AND password :pwd); query.bindValue(:user, username); query.bindValue(:pwd, password); if (!query.exec()) { qDebug() 登录查询失败 query.lastError().text(); return false; } return query.next(); }prepare预编译之后通过bindValue绑定两个占位符变量MySQL 会把用户名和密码当成纯字面量处理而不是把它当成 SQL 语法的一部分去解析。这也是在课程设计答辩时能主动展示的一个亮点你说自己用了预处理防注入比说“我把查询写出来了”要高一个档次。注意登录密码存在数据库里时更规范的做法是存哈希而不是明文但课程设计阶段如果老师没有特殊要求很多工程都是直接存明文能理解但要心里有数。4.2 列表展示与分页QTableView 配合 LIMIT 语句学生信息列表如果用 QTableWidget 把所有数据一次性塞进去数据量几百条时还能接受但是一旦上千条界面卡顿是必然的。更合理的方式是用分页查询每次只从数据库取一页数据。Qt 里可以用 QTableView 作为载体配合 QSqlQuery 逐行读取数据。QVectorQStringList fetchStudents(int page, int rowsPerPage) { QVectorQStringList result; QSqlQuery query; int offset (page - 1) * rowsPerPage; query.prepare(SELECT sno, name, gender, major, class_no, phone FROM tb_student ORDER BY sno LIMIT :limit OFFSET :offset); query.bindValue(:limit, rowsPerPage); query.bindValue(:offset, offset); if (!query.exec()) { qDebug() 分页查询失败 query.lastError().text(); return result; } while (query.next()) { QStringList row; for (int i 0; i query.record().count(); i) { row.append(query.value(i).toString()); } result.append(row); } return result; }这里的LIMIT :limit OFFSET :offset是 MySQL 分页的标准写法offset计算规则是“(页码 - 1) * 每页条数”。第一页的 offset 为 0第二页的 offset 等于每页条数以此类推。需要注意一点必须给分页查询加稳定的ORDER BY子句否则 MySQL 返回结果的顺序不固定翻页时可能出现同一行数据在不同页重复出现的假象。这也是数据库分页里的一个经典陷阱。4.3 增删改查的通用封装一个函数复用四种操作同一个系统里新增学生、修改学生、删除学生、修改密码这几类操作都是执行一条 SQL 再加参数绑定逻辑高度相似。工程里如果每个操作都写一遍完整流程代码会膨胀且难维护。更干净的做法是封装一个通用的更新执行函数接收 SQL 和参数列表统一处理预编译与错误捕捉。bool execUpdate(const QString sql, const QVariantList args) { QSqlQuery query; if (!query.prepare(sql)) { qDebug() SQL 预编译失败 query.lastError().text(); return false; } for (int i 0; i args.size(); i) { query.addBindValue(args.at(i)); } if (!query.exec()) { qDebug() SQL 执行失败 query.lastError().text(); return false; } return true; }调用时只需要把 SQL 语句和参数按顺序传入即可。比如插入学生就是execUpdate(INSERT INTO tb_student(sno,name,gender) VALUES(?,?,?), {20230001, 张三, 男})按索引绑定参数不用像具名绑定那样操心冒号名。这里有个容易踩的小坑addBindValue是按调用顺序绑定到 SQL 里的问号占位符参数列表的顺序必须和 SQL 中问号的出现顺序严格一致否则数据会串列。4.4 搜索功能动态拼 SQL 时防止条件堆积问题搜索是列表页的标配但动态条件拼接很容易写出“条件失效”的 bug。如果你写死一条固定 SQL当用户把搜索框清空时WHERE子句后面没有条件就会报语法错误。我一般的做法是先固定查询主干再根据条件是否为空决定要不要追加WHERE片段。QString sql SELECT sno, name, major FROM tb_student WHERE 11; QVariantList args; if (!keyword.isEmpty()) { sql AND (name LIKE ? OR sno LIKE ?); args % keyword % % keyword %; }这个写法的核心技巧是WHERE 11它本身永远为真后面每一个动态条件都用AND拼接这样条件不存在时也不会破坏 SQL 语法。LIKE模糊匹配的百分号需要拼进参数里而不是拼在 SQL 文本里否则%在绑定参数时会变成字符串内容的一部分查询结果反而会出错。绑定完成后继续调用上一节那个execUpdate函数整个搜索模块就只有几行代码同时保持了预编译的安全性。5. 避坑记录驱动加载失败、中文乱码与连接异常实战排查5.1 现象一QMYSQL driver not loaded驱动加载失败拿到工程在自己电脑上第一次运行时控制台最常见的报错是QSqlDatabase: QMYSQL driver not loaded。这个报错不代表代码有问题而是 Qt 运行时找不到 MySQL 的驱动插件。Qt 的数据库驱动是独立插件正常情况下位于 Qt 安装目录的plugins/sqldrivers文件夹下里面应该有qsqlmysql.dll或qsqlmysql.so文件。原因安装 Qt 时没有勾选 MySQL 驱动组件或者系统中缺少 MySQL 客户端动态库 libmysql.dll。很多初学者下载的是精简安装包自带插件不完整驱动自然加载不了。解决先用文件管理器找到 Qt 的sqldrivers目录确认有没有qsqlmysql.dll。如果没有重新运行 Qt 的安装维护工具在组件选择中勾选 “MySQL Driver” 或 “Qt SQL Drivers” 一项也可以从有该驱动的另一台机器拷贝对应文件放到本机插件目录。若插件存在但仍报错则很可能是缺libmysql.dll把它放到程序执行目录或系统 PATH 即可。注意位数必须一致32 位程序对应 32 位库64 位对应 64 位混着放会继续报同样的错。5.2 现象二Cant connect to MySQL server连接不上数据库界面启动后弹窗提示Cant connect to MySQL server on 127.0.0.1 (10061)。这个报错通常跟代码逻辑没有关系是数据库服务侧根本没准备好接受连接。原因MySQL 服务没有启动端口不是默认的 3306或者 root 账号不允许从当前主机登入。开发时最容易忽略的一点是 MySQL 8.0 的默认认证插件与 Qt 自带驱动不兼容也会报连接失败或认证失败只是错误文本不太一样。解决先打开命令行输入mysql -h127.0.0.1 -P3306 -uroot -p手动测一次连接如果这里都连不上先排查 MySQL 服务是否启动、端口是否被占用。如果命令行能连、但 Qt 报错重点检查代码里的密码、库名、host 是否有拼写错误。若报错与认证插件有关在 MySQL 命令行里执行下面这条语句把 root 用户认证方式切换成传统格式ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;这条命令在开发机上执行一次即可把密码替换成实际密码。切换后 Qt 再用 QMYSQL 连接就不会卡在认证协议上了。5.3 现象三中文乱码从建库到查询显示都是问号插入的中文数据显示出来全是“?”或者“锟斤拷”这是 Qt MySQL 项目里出现频率最高的编码问题。乱码的根源只有一个从数据库到客户端各环节字符集不统一。原因数据库是 latin1Qt 端是 UTF-8或者表字段字符集不统一。MySQL 默认字符集在老版本里可能是 latin1关于中文数据就没法存。还有一层原因是 Qt 连接建立后没有通知 MySQL 用 UTF-8 做通信编码。解决三层都要对齐。建库时指定DEFAULT CHARACTER SET utf8mb4这个在 3.1 节的 SQL 脚本里已经体现连接成功后在代码里执行一次SET NAMES utf8mb4Qt 编译器源码文件本身保持 UTF-8 编码保存。如果项目里既有老库又有新库老库的字符集已经变不回来就单独对连接设置db.setConnectOptions(MYSQL_SET_NAMESutf8mb4)这是 Qt 对SET NAMES的直接封装方式。5.4 现象四主键断层删除记录后新增数据 id 不连续删除几行学生数据后再插入新数据自增 id 跳跃式增长列表里出现不连续的编号。严格说这不算 bug是AUTO_INCREMENT列的正常行为但在课程设计验收时如果被问到还是需要答得有理有据。原因MySQL 的自增列计数不会因为删除回退这是为避免并发插入冲突做的设计。删除第 5 条后下一条自增 id 可能是 6也可能是更大值取决于当前自增计数器的状态。解决如果你用自增 id 做物理主键不要试图手动修改 id 来让数据连续那只会破坏外键关系和索引。如果列表展示想显示连续序号可以在查询时用 MySQL 的ROW_NUMBER()窗口函数生成虚拟序号不动底层数据。更稳妥的办法是像 3.1 节设计的那样直接用学号做主键业务上天然唯一就不会有这种“看起来不连续”的尴尬。5.5 现象五换电脑运行闪退缺 MySQL 客户端动态库在自己电脑上编译好的 exe拷到另一台没有装开发环境的机器上双击运行直接闪退或提示缺少 DLL。这是 Qt 程序部署最普遍的坑。原因Qt 程序运行时依赖 Qt 的众多动态库MySQL 连接则依赖libmysql.dll这些文件在你开发机上由安装环境提供但在普通电脑上不存在。解决不能直接拷贝 exe打包发布要用 Qt 自带的部署工具windeployqt。在命令行进入 exe 所在目录执行windeployqt 你的程序名.exe它会把 Qt 相关的 DLL 和插件目录自动复制到旁边。但windeployqt不负责 MySQL 客户端库需要单独从 MySQL 安装目录把libmysql.dll复制到程序目录。缺少这个文件时程序往往不是报“找不到驱动”而是干脆闪退所以部署完成后最好在目标机器上完整跑一遍登录和查询流程。6. 让这套系统能交付打包发布与验证习惯6.1 用 windeployqt 把程序变成免安装版开发完不是终点能把工程打包成一个免安装目录才算闭环。以 Windows 平台为例先在 Qt Creator 里用 Release 模式编译生成 exe然后打开命令行按下面的顺序执行mkdir deploy cd deploy windeployqt StudentManager.exewindeployqt会解析 exe 依赖的 Qt 模块自动复制核心动态库、qsqldrivers 插件、图标主题等资源。完成后检查sqldrivers目录下是否有qsqlmysql.dll没有就得去 Qt 的插件目录手动拷一份。还有一个高频遗漏点libmysql.dll不会再被自动处理你需要从 MySQL 安装目录的lib文件夹里找到它并放入 deploy 目录否则程序在没装 MySQL 客户端的机器上就废了。6.2 交付前的验证清单换库、换目录、换机器我每次拿到类似工程做测试都会强制执行一遍交付验证流程你可以直接抄作业换一个干净的 MySQL 实例导入 sql 脚本建库确认脚本本身没有依赖本地已有的数据。换一个非源码目录的位置运行 exe确保程序不依赖开发环境的相对路径。换一台没装 Qt 的机器运行验证部署目录里的 DLL 是否齐全。用角色不同的账号分别登录确认权限控制不是摆设。这套流程看起来土却能拦下九成“在我电脑上能跑”的翻车问题。很多资源包在作者环境下正常换个人就找不到数据库多半是 sql 脚本没导入或者连接参数写死成作者本机的密码。拿到这套项目后把数据库连接参数单独提取出来放到配置文件里是提升可交付性的关键一步。6.3 一点进阶从课程设计到可复用的管理系统基础功能跑通后还可以在代码框架上做几处低成本扩展列表数据导出成 CSV 文件只需要遍历 QTableView 行数据并写文件给成绩字段做柱状图展示可以引入Qt Charts模块把 MySQL 连接改成从 QSettings 读取配置文件部署时不用改一行代码。这些进阶点不依赖额外的第三方库都是在现有 Qt 工程上增加模块就能完成。从那以后我每次交付 Qt 加 MySQL 的工程都强制自己走一遍“换电脑验证”的流程抽掉开发机的 MySQL用目标机器数据库跑一遍登录、增删改查、分页三件事全部通过后再压缩打包发送。很多驱动缺失和字符集错乱的幺蛾子都是在这一步提前拦下来的。希望帮到你。本文还有配套的精品资源点击获取