简介基于QT框架的学生管理系统源码包面向C与QT初学者、计算机相关专业学生可用于课程设计或期末项目参考。系统实现了学生信息的增删改查、按学号/姓名/分数查询以及升降序排序后台采用SQLite数据库自动建表存储界面基于QT Widgets构建便于理解桌面应用开发流程。压缩包内共27个文件包含5个cpp源文件、3个头文件、UI界面文件、qrc资源文件、pro工程文件、SQLite db数据库文件、Makefile以及可直接运行的exe程序包体仅1.64MB代码结构清晰适合对照学习。目前已有70人学习下载。通过本项目可掌握QT信号槽机制、SQLite增删改查操作、界面布局与事件处理等核心知识点配合QT 5.12.9及以上版本与MinGW 32位环境即可编译运行同时提供README说明与编译配置便于快速搭建开发环境并调试是一套完整轻量的学生管理实践案例。1. 学生管理系统的QT框架源码入手前先认清这三件事一份QT框架的学生管理系统源码解压后排在眼前的往往是一堆头文件和cpp配上数据库文件第一眼和普通桌面程序没什么区别。真把它当参照开发自己的版本时容易在三个地方踩坑编译器换一套就链接失败数据访问散落在各个窗口里exe换个目录就找不到SQLite文件。这个标题里真正值钱的不是“学生管理”而是那套QT项目结构——登录、表格、表单、数据库驱动在框架里是有标准写法的。这篇就按工程结构、数据库层、业务逻辑、编译排错、打包改造的顺序把这套源码拆一遍。2. QT框架学生管理系统的工程结构与数据层设计学生管理系统工程量不大但目录不摆清楚照样能把人绕晕。这类型的zip解开之后主体是一个工程文件加五六个类文件数据访问单独放界面单独放再跟一个sqlite数据库文件。搞清楚这些东西的角色比先抢着点编译更重要。StudentManager/ │ student_manager.pro │ ├─ main.cpp ├─ loginwidget.h / loginwidget.cpp ├─ mainwindow.h / mainwindow.cpp ├─ studentdao.h / studentdao.cpp ├─ databasehelper.h / databasehelper.cpp └─ data/ └─ student.db打开顺序应该是先看.pro再看main.cpp然后看databasehelper最后才进mainwindow。.pro决定工程能不能编译main.cpp告诉你在哪儿启动databasehelper说明数据库从哪来后面所有列表操作都依赖它。2.1 从.pro文件看QT框架模块依赖省掉一半编译报错QT工程的构建入口不是某个源码文件而是.pro。qmake读它解析出模块配置再生成对应的Makefile。学生管理系统里最常见的.pro长这样QT core gui sql greaterThan(QT_MAJOR_VERSION, 4): QT widgets TARGET StudentManager TEMPLATE app CONFIG c11 FORMS mainwindow.ui \ loginwidget.ui SOURCES main.cpp \ mainwindow.cpp \ loginwidget.cpp \ studentdao.cpp \ databasehelper.cpp HEADERS mainwindow.h \ loginwidget.h \ studentdao.h \ databasehelper.hQT core gui sql把数据库模块挂进来只要代码里出现过QSqlDatabase、QSqlQuery就依赖这一行。FORMS里列的是.ui文件用Qt Designer拖出来的界面都在这里登记漏掉会报找不到ui_xxx.h。TARGET是要生成的exe文件名TEMPLATE app说明产出是一个可执行程序不是库。还有一行容易被忽略CONFIG c11。旧的源码可能是CONFIG c11或者什么都不写新编译器默认值变了老代码里惯用的隐式转换对不上就会报错。检查源码用到的语法C11够用就没必要开C17。2.2 学生表怎么设计源码里SQLite建表的常见套路学生管理系统的数据层不复杂核心就三张表学生、课程、成绩。很多课程的示例源码会把表结构写在databasehelper的初始化函数里程序第一次启动时自动建表CREATE TABLE IF NOT EXISTS students ( id INTEGER PRIMARY KEY AUTOINCREMENT, student_no TEXT NOT NULL UNIQUE, name TEXT NOT NULL, gender TEXT DEFAULT 男, class_name TEXT, phone TEXT, enroll_year INTEGER ); CREATE TABLE IF NOT EXISTS courses ( course_id INTEGER PRIMARY KEY AUTOINCREMENT, course_name TEXT NOT NULL ); CREATE TABLE IF NOT EXISTS scores ( score_id INTEGER PRIMARY KEY AUTOINCREMENT, student_no TEXT, course_id INTEGER, score REAL, UNIQUE(student_no, course_id) );用student_no做关联字段比较直观因为学号本来就不该重复。没有整编数据的时候可以先不建major专业表一个class_name文本字段能应付大多数演示功能。这里有个SQLite的边界要知道外键约束默认是关闭的。scores里的student_no如果对应不上students只要前置条件满足照样能插入。批量删学生时干脆连成绩一起删的做法在课程源码里很普遍严格系统里应该用外键或事务协议保证一致性。改代码前先把这三张表之间要不要强关联想清楚别被示例拖着走。2.3 QSqlTableModel 与 QTableViewQT框架里最顺手的表格方案学生管理界面熬到最后就是一张QTableView把QSqlTableModel塞进去QSqlTableModel *model new QSqlTableModel(this); model-setTable(students); model-setEditStrategy(QSqlTableModel::OnManualSubmit); model-setSort(0, Qt::AscendingOrder); model-select(); ui-tableView-setModel(model);setEditStrategy三种取值对应三种提交时机OnFieldChange是单元格改完马上写库OnRowChange是换下一行时提交OnManualSubmit是把提交动作交给“保存”按钮。学生管理这类带编辑的操作界面推荐OnManualSubmit用户在界面上改错了来得及回退不会一行输错库里就变脏。select()这一步才是真正执行SELECT * FROM students的地方。表名拼写错误、数据库文件路径不对全都在这时候暴露。源码里如果只有一张QTableView挂着一个QSqlTableModel那是适合学结构不是适合做真实系统。真实系统会把model封装在数据访问层里表格只负责显示数据掉电由业务代码控制。提示调试时如果表格里没有内容先检查model-lastError().text()输出了什么。QSqlTableModel不会主动把错误弹窗给你看单靠界面空白没法判断是没查到还是查询失败。3. QT框架学生管理系统的核心实现登录、事务与检索学生管理系统的业务集中在三块登录验证、增删改、按条件找学生。源码里对应的代码通常分布在loginwidget和studentdao两个地方UI上只保留槽函数和model调用。这样的分层才有改的价值不然和别人直接写在按钮里的示例有什么区别。3.1 登录验证用 prepare 绑定参数别再用字符串拼SQL登录框是大多数学生管理系统打开后面对的第一个界面。判断一个QT源码写得规不规范看一眼登录SQL怎么写就够了。最忌讳的写法是直接把输入拼进查询串QString sql SELECT * FROM admins WHERE account account ; QSqlQuery query(sql);这种写法在单机学生管理程序里也可能不出事但它直接把输入拼进SQL单引号、注释符都会改变语义属于彻头彻尾的反面教材。规范的登录验证应该用占位符QSqlQuery query; query.prepare(SELECT password, role FROM admins WHERE account ?); query.addBindValue(ui-accountEdit-text().trimmed()); if (!query.exec()) { qDebug() login failed: query.lastError().text(); return; } if (query.next()) { QString hash query.value(password).toString(); if (hash encryptPassword(ui-passwordEdit-text())) { QMessageBox::information(this, 登录, 欢迎使用学生管理系统); accept(); // 登录成功关闭登录窗口进入主界面 } }prepare先把查询结构发给数据库引擎addBindValue补上参数引擎拿到的是已经分开的结构和数据输入内容再奇怪也不会改变SQL结构。这是QT框架里QSqlQuery的标准用法和MySQL驱动、SQLite驱动无关规则通用。登录密码不要明文存储。至少用非对称的散列处理再落库QString LoginWidget::encryptPassword(const QString raw) { return QString(QCryptographicHash::hash( raw.toUtf8(), QCryptographicHash::Sha256).toHex()); }源码里如果看到它对密码做加密说明作者对自己的安全策略有意识改造成本也低。如果这个密码是明文干脆自己在databasehelper里同步一套admins表结构把明文列换成散列列顺便给自己练练手。3.2 学生信息插入与删除用事务包住批量操作新增学生的代码集中在数据访问层界面按钮只管收集输入。以StudentDao为例插入函数会做两件事检查学号唯一性、执行插入。bool StudentDao::addStudent(const QString no, const QString name, const QString gender, const QString cls) { QSqlDatabase db QSqlDatabase::database(); db.transaction(); QSqlQuery query(db); query.prepare(SELECT id FROM students WHERE student_no ?); query.addBindValue(no); query.exec(); if (query.next()) { db.rollback(); return false; // 学号已存在拒绝插入 } query.prepare(INSERT INTO students(student_no, name, gender, class_name) VALUES (?, ?, ?, ?)); query.addBindValue(no); query.addBindValue(name); query.addBindValue(gender); query.addBindValue(cls); bool ok query.exec(); if (ok) { ok db.commit(); } else { db.rollback(); qDebug() insert error: query.lastError().text(); } return ok; }db.transaction()开启一个事务后续SQL都包在里面。“学号不存在再插入”两步是一个整体中间哪一步失败整个操作退回原点。数据访问层里做事务是QT数据库编程里很稳定的习惯能防止主表写进去了、关连带学号没进去这种半截数据。批量删除更要靠事务。常见应用场景是在QTableView里勾选多行一次性删除。源码里常这么处理QItemSelectionModel *selection ui-tableView-selectionModel(); QModelIndexList selectedRows selection-selectedRows(); QSqlDatabase db QSqlDatabase::database(); db.transaction(); QSqlQuery query(db); for (const QModelIndex index : selectedRows) { int id index.sibling(index.row(), 0).data().toInt(); query.prepare(DELETE FROM students WHERE id ?); query.addBindValue(id); if (!query.exec()) { db.rollback(); return; } } db.commit();selectedRows拿到的是选中行在view里的视觉坐标不是数据库主键。所以先取sibling(row, 0)取得主键列再删数据。这个细节多半学生管理系统源码里的运用相当重要不然删的总是错行。3.3 按姓名学号实时搜索QSortFilterProxyModel 还是 SQL LIKE搜索框在界面上连着QLineEdit的textChanged信号常见实现是QSortFilterProxyModel它从内存里过滤当前已加载的model不用回捣数据库proxyModel new QSortFilterProxyModel(this); proxyModel-setSourceModel(studentModel); proxyModel-setFilterKeyColumn(-1); // -1表示过滤所有列 proxyModel-setFilterCaseSensitivity(Qt::CaseInsensitive); ui-tableView-setModel(proxyModel);setFilterKeyColumn(-1)是QT框架里一个比较容易被忽略的开关。默认值是0只过滤第0列行为结果是输入姓名没反应因为第0列多半是id。传-1就表示所有列都参与匹配。setFilterCaseSensitivity(Qt::CaseInsensitive)忽略大小写不然输小写字母搜不出。槽函数里只需要一行调用void MainWindow::on_searchEdit_textChanged(const QString text) { proxyModel-setFilterFixedString(text.trimmed()); }当输入变化时多次调用setFilterFixedString大量触发也不会有数据库压力因为数据全在内存里。可是数据量变大之后就要区分场景了。小型学生管理系统几百个学生无所谓上万条还全量载入内存和下拉都挺难受。此时推荐在SQL层面做过滤SELECT * FROM students WHERE student_no LIKE :kw OR name LIKE :kw OR class_name LIKE :kw LIMIT 50;两种方式取舍有明确边界方式适合规模实时性注意点QSortFilterProxyModel5千行以内一次load输入即过滤全量常驻内存SQL LIKE LIMIT万行以上需要防抖可配合QTimerWHERE条件要建配合查询效率QTimer防抖的意思是输入停下来300毫秒再发起查询避免每敲一个字符都向sqlite发一次LIKE。这套路在真实改造里很常用。4. 把QT源码跑起来版本选择、编译调试与数据库路径源码包拿到手第一件碰运气的事是编译环境。QT不像普通C程序那样一个编译器走天下模块与编译器版本之间咬得很死。折腾清楚这步才谈得上改功能和打包。4.1 MSVC 和 MinGW 怎么选版本对不上会怎样学生管理系统最常见的是QT5.15.2或QT 6.x的工程。QT版本和编译器必须严格对应Qt官方安装包把Windows版本分成MSVC和MinGW两组两个编译器的结构、命名规则都不一样不能混用。QT版本推荐编译器说明QT 5.15.2MSVC2019 64bit 或 MinGW 8.1 64bit老工程兼容性最好最稳妥QT 6.5MSVC2022 64bit 或 MinGW 11.2新工程推荐用CMake为主QT 6.2以下尽量别用模块拆分差异老源码编译成本高在Qt Creator里打开.pro工程时左侧套件选择器会列出已安装的编译器。如果源码由MSVC生成而你只装了MinGW常见症状是LNK相关链接错误或“无法打开lib文件”。反过来也一样。原来程序的.pro在项目根目录打开Qt Creator点“打开项目”选择这个.pro文件套件选对后点构建就行。命令行编译的话先进入QT安装目录下的编译环境Windows上一般这样起qmake StudentManager.pro -spec win32-g mingw32-make -j4qmake StudentManager.pro -spec win32-msvc nmake4.2 数据库路径才是运行崩溃的隐藏炸弹学生管理系统启动白屏、登录后表格空白大概率是数据库文件没被找到。源码里最常见的问题是setDatabaseName传了个相对路径db.setDatabaseName(student.db);相对路径相对于进程的工作目录。在Qt Creator里按F5调试时工作目录是构建目录双击release目录里的exe时工作目录是exe所在目录打包后从别的目录启动路径又不一样。同一份代码在不同环境下读到的是不同的“student.db”自然要么找不到表要么数据不对。稳定做法是把数据库路径定位到exe所在目录的data子目录QString dbDir QCoreApplication::applicationDirPath() /data; QDir().mkpath(dbDir); QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE); db.setDatabaseName(dbDir /student.db); if (!db.open()) { qDebug() open db error: db.lastError().text(); }applicationDirPath()永远指向当前运行的exe文件路径不会随工作目录变化。mkpath先建目录避免第一次运行时因为路径不存在而打开失败。源码里如果是写在main.cpp里直接执行这段最好挪到databasehelper类中便于复用和测试。4.3 用qDebug和断点快速定位QT源码问题QT调试的第一手段是给自己的代码加上输出。很多运行期问题不弹窗不报错界面只是没反应。判断query是否有异常在SQL执行后检索lastError()if (!query.exec()) { qDebug() [SQL] query.lastQuery(); qDebug() [ERROR] query.lastError().text(); return false; }至于UI信号不正常检查槽函数有没有和执行按钮的clicked信号连起来。在Qt Creator编辑界面右键按钮选择“转到槽”或者在构造函数里检查有没有connect(ui-addButton, QPushButton::clicked, this, MainWindow::onAddStudent);槽函数里的断点如果根本没触发先看连接触发了但表格不变再看model的select()和submitAll()是否调用。乱码这种老生常谈QT5里大多数和源码文件本身编码有关。源码文件必须是UTF-8而Windows老工程可能是GBK窗体现在显示中文乱码时改文件编码。QT6对UTF-8更严格老代码里的QString::fromLocal8Bit也建议改成普通字符串常量。5. 用windeployqt打包发布再给源码加一个CSV导入页面开发最后一步给这个桌面程序装个壳。不用写安装程序带一大推DLL麻烦QT自带windeployqt一句命令就能把依赖全部集齐成绿色目录。cd /d D:\build\StudentManager\release windeployqt StudentManager.exe执行后自动把platforms、styles、sqldrivers等文件夹连同Qt DLL复制到当前目录。.exe的路径以及发布目录与Qt套件的位数必须相匹配——32位工程用64位的windeployqt随之而来的DLL加载不了。发布前要确认目录里生成了sqldrivers/qsqlite.dll没有它换一台机器启动后界面打开就是“QSQLITE driver not loaded”。这步往往在源码里不显眼不用打包时注意不到。二次开发的话推荐给这个源码加一个CSV批量导入功能它能把数据库层、UI层、信号槽串起来练一次就明白源码结构。改动集中在mainwindow里新增一个导入槽函数void MainWindow::onImportCsv() { const QString filePath QFileDialog::getOpenFileName( this, 选择CSV, QString(), CSV 文件 (*.csv)); if (filePath.isEmpty()) return; QFile file(filePath); if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { QMessageBox::warning(this, 导入, 无法打开文件); return; } QTextStream in(file); int okCount 0, failCount 0; while (!in.atEnd()) { const QString line in.readLine().trimmed(); if (line.isEmpty()) continue; const QStringList cols line.split(,); if (cols.size() 3) { failCount; continue; } if (StudentDao::addStudent(cols[0], cols[1], cols[2], cols.value(3))) okCount; else failCount; } file.close(); refreshAll(); QMessageBox::information(this, 导入完成, QString(成功 %1 条跳过 %2 条).arg(okCount).arg(failCount)); }CSV先按逗号切列列数小于3就跳过。返回值里多一个3只导入前四列。addStudent内部如果把学号重复也算失败失败次数统计里会自然包含重复数据。更严谨的CSV处理会把引号、转义、BOM头都处理掉这个函数只做雏形够用。导入入口挂一个QPushButton在构造函数里补一行connect就能跑通。改动文件加好后记得同步检查.pro文件里的HEADERS和SOURCES特别是新增类的时候。要么选择在Qt Creator里“添加新文件”再勾选自动更新.pro要么手动补两行不然下次换机器再编译时报错说着找不到头文件实际是工程文件里没登记。本文还有配套的精品资源点击获取