简介这是一套基于Qt与SQL开发的试题库管理系统完整课程设计实现面向计算机专业本科生及C/数据库初学者解决高校课程设计中题库管理软件从需求分析、数据库建模到GUI界面落地的全流程实践问题。资源包共47个文件涵盖5个核心cpp/h源码文件含Login、TableView、dialog等模块、3个UI界面文件、5个QSS样式表与4个ICO图标资源辅以SQL建库脚本、数据流图与模块实现文档docx、课程设计报告及任务书等教学材料整体1.29MB结构清晰、工程规范。已有1708人学习下载读者可直接编译运行Qt项目深入理解C信号槽机制、SQLite数据库操作、MVC界面分层设计并获得从概念模型→逻辑设计→代码实现→文档撰写的全链路参考范例特别适合课程设计复盘与数据库应用开发入门实战。1. 一个能离线跑、带完整 CRUD 和模糊搜索的 Qt 试题库管理系统专治「出卷前翻三遍 Excel 还漏题」的焦虑你有没有过这种经历临近期末教研组临时要出三套难度梯度分明的试卷结果打开那个叫“2023_题库_v7_最终版_真的最终版.xlsx”的文件发现题干里混着“待审核”“图片丢失”“答案疑似有误”的批注筛选条件一多就卡死想按知识点难度年份组合查题Excel 自带筛选直接罢工这个 Qt SQLite 实现的试题库管理系统就是为这种场景而生的——它不依赖网络、不连远程数据库、不搞微服务架构整个系统打包后不到 15MB双击就能运行支持题目增删改查、按学科/章节/难度/题型/关键词全文模糊搜索、批量导入导出 Excel含格式保留、题目去重与状态标记。它不是教学平台也不是 SaaS 系统就是一个扎扎实实跑在本地的桌面工具适合教研组长、命题教师、培训机构题库维护员这类需要高频、稳定、可控操作题目的角色。如果你正在找一个能立刻放进 U 盘、插进教室电脑、不装环境不配服务器、改完即生效的试题管理方案那它不是“可能有用”而是“今天下午就能开始用”。2. 技术栈与工程结构为什么选 Qt SQLite 而不是 Electron 或 Django这个项目没走 Web 路线也没上云核心决策非常务实命题场景下稳定性 新潮感启动速度 功能堆砌离线可用 实时协同。我们来一层层拆。2.1 为什么是 Qt 而不是其他 GUI 框架Qt 的 C 底层决定了它对资源占用极其克制——实测在 4GB 内存的老式办公机上主界面加载 5000 道题后内存占用仍稳定在 80MB 左右其信号槽机制让 UI 与业务逻辑解耦干净比如点击“搜索”按钮后不写一行document.getElementById而是直接触发SearchManager::onSearchTriggered()后续所有过滤、高亮、分页都由纯 C 对象完成UI 层只负责渲染。更重要的是Qt Creator 内置的.ui文件可视化编辑能力让调整“添加题目”对话框的布局、拖拽调整表格列宽、设置树形目录控件的展开逻辑全部所见即所得不用反复写 CSS 或调试 React 组件生命周期。这不是技术怀旧而是当你要在 20 分钟内帮隔壁老师修好“导入后题干乱码”问题时Qt 的编译报错定位和调试器集成比任何跨平台框架都更接近“开箱即修”。2.2 为什么 SQLite 是唯一数据库选择项目正文虽只提了 “Sql”但源码中所有数据库操作均指向QSqlDatabase::addDatabase(QSQLITE)。SQLite 不是“凑合用”而是精准匹配需求零配置部署整个数据库就是一个.db文件无需安装 MySQL 服务、无需配置用户权限、无需处理端口冲突。安装包解压后首次运行自动创建exam_db.sqlite路径默认在QStandardPaths::writableLocation(QStandardPaths::AppDataLocation)下Windows 在%APPDATA%\ExamDB\macOS 在~/Library/Application Support/ExamDB/。ACID 保障下的轻量事务每道题的保存是一个事务包含题干、选项、答案、解析、标签等 12 个字段的原子写入。即使导入中途断电也不会出现“题干写了但答案丢了”的半截数据。源码中QuestionDAO::saveQuestion()方法里明确包裹了transaction()/commit()/rollback()三段式结构。全文搜索原生支持FTS5这是关键。SQLite 的 FTS5 扩展让“搜‘牛顿第二定律’同时命中题干、选项、解析”成为可能且响应时间在万级题目下仍控制在 200ms 内。对比传统LIKE %xxx%全表扫描性能提升不是数量级而是体验级——你不会在搜索框输完字就看到转圈光标。2.3 工程目录结构6 个核心模块各司其职不越界项目采用典型的 Qt Model-View 架构目录按职责划分清晰没有“万能 utils”或“上帝类”src/ ├── main.cpp // Qt 应用入口仅初始化 QApplication 和主窗口 ├── MainWindow.h/cpp // 主界面左侧导航树学科/章节、中部题库表格、右侧预览面板 ├── dao/ // Data Access Object纯数据操作层不碰 UI │ ├── QuestionDAO.h/cpp // 封装所有题目 CRUD含 FTS5 搜索接口 │ └── TagDAO.h/cpp // 标签管理知识点、难度、题型等枚举值持久化 ├── model/ // 数据模型层QAbstractTableModel 子类对接表格视图 │ └── QuestionTableModel.h/cpp // 将 QuestionDAO 查询结果转化为表格可绑定的数据 ├── widgets/ // 自定义 UI 组件 │ ├── QuestionEditorWidget.h/cpp // “添加/编辑题目”弹窗含富文本题干编辑器 │ └── SearchBarWidget.h/cpp // 带历史记录、搜索范围勾选题干/选项/解析的搜索栏 └── utils/ // 工具函数Excel 导入导出用 QXlsx 库、文件路径处理、JSON 配置读写提示所有 DAO 类都通过QSqlDatabase::database()获取全局连接实例避免多线程下连接泄漏。utils/ExcelHelper.cpp中importFromXlsx()方法会先校验 Excel 表头是否含[题干, A选项, B选项, 答案, 解析]缺失则抛出ImportException并提示具体哪列缺失——这比让用户导入后看到一片空表格再回头检查强十倍。3. 核心模块拆解从一道题的诞生到被搜出来完整链路我们以“新增一道高中物理力学选择题”为例追踪代码如何把用户操作变成磁盘上的可靠数据并最终被搜索命中。3.1 添加题目QuestionEditorWidget 如何保证数据完整性当用户点击“添加题目”按钮弹出QuestionEditorWidget。它的构造函数接收一个Question对象新增时为空对象所有输入控件QTextEdit题干、QComboBox难度、QCheckBox标签等都与该对象属性双向绑定。关键逻辑在onSaveClicked()槽函数中void QuestionEditorWidget::onSaveClicked() { // 1. 从 UI 提取数据构建 Question 对象 Question q; q.stem ui-stemEdit-toPlainText().trimmed(); // 题干去首尾空格 q.answer ui-answerCombo-currentText(); q.analysis ui-analysisEdit-toPlainText(); q.difficulty ui-difficultySlider-value(); // 难度 1~5 滑块 q.subject Physics; // 从导航树继承非手动输入 q.chapter m_currentChapter; // 同上 // 2. 前端校验题干不能为空至少两个选项隐含在 UI 结构中 if (q.stem.isEmpty()) { QMessageBox::warning(this, 输入错误, 题干不能为空); return; } // 3. 交由 DAO 层保存 bool success QuestionDAO::instance()-saveQuestion(q); if (success) { emit questionSaved(q); // 发出信号通知主窗口刷新表格 this-close(); } else { QMessageBox::critical(this, 保存失败, 数据库写入异常请检查磁盘空间或联系管理员); } }这段代码的“血泪经验”在于校验必须在 DAO 层之前做。如果把空题干交给QuestionDAO::saveQuestion()它会尝试插入NULL到stem字段该字段在建表时设为NOT NULLSQLite 抛出QSqlError::StatementError但错误信息是英文且笼统constraint failed用户根本看不懂。而前端校验能给出中文、具体、可操作的提示。3.2 数据库建表FTS5 全文索引如何设计QuestionDAO::initDatabase()在首次运行时执行建表。核心是两张表questions主表和questions_ftsFTS5 虚拟表-- 主表存储结构化数据 CREATE TABLE IF NOT EXISTS questions ( id INTEGER PRIMARY KEY AUTOINCREMENT, stem TEXT NOT NULL, option_a TEXT, option_b TEXT, option_c TEXT, option_d TEXT, answer TEXT NOT NULL, analysis TEXT, difficulty INTEGER CHECK(difficulty BETWEEN 1 AND 5), subject TEXT NOT NULL, chapter TEXT NOT NULL, tags TEXT, -- JSON 数组字符串如 [牛顿定律,计算题] status TEXT DEFAULT normal, -- normal/review/deprecated created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ); -- FTS5 虚拟表专为全文搜索优化 CREATE VIRTUAL TABLE IF NOT EXISTS questions_fts USING fts5( stem, option_a, option_b, option_c, option_d, analysis, contentquestions, content_rowidid );关键点contentquestions表明该 FTS 表的内容来源是questions表content_rowidid建立 FTS 行 ID 与主表id的映射所有需搜索的文本字段题干、四个选项、解析都显式列出不包含tags字段——因为标签是结构化数据用WHERE tags LIKE %\力学\%更高效全文索引反而降低精度。注意FTS5 表不会自动同步主表变更必须在QuestionDAO::saveQuestion()中手动触发更新// 插入主表后立即向 FTS 表插入对应行 QSqlQuery ftsQuery(db); ftsQuery.prepare(INSERT INTO questions_fts(rowid, stem, option_a, option_b, option_c, option_d, analysis) VALUES(?, ?, ?, ?, ?, ?, ?)); ftsQuery.addBindValue(q.id); ftsQuery.addBindValue(q.stem); // ... 绑定其他字段 ftsQuery.exec();3.3 模糊搜索如何让“牛顿”搜出“牛顿第一定律”和“牛顿第三定律”搜索功能由QuestionDAO::searchQuestions()实现它接受一个QString keyword和搜索范围标志位SearchScope枚举。核心是构造 FTS5 的MATCH查询QString buildFtsQuery(const QString keyword, SearchScope scope) { QStringList columns; if (scope.testFlag(SearchScope::Stem)) columns stem; if (scope.testFlag(SearchScope::Options)) columns option_a option_b option_c option_d; if (scope.testFlag(SearchScope::Analysis)) columns analysis; // 使用 FTS5 的 prefix search牛顿* 匹配所有以“牛顿”开头的词 QString ftsKeyword keyword.trimmed() *; // 构造 MATCH 字符串如(stem:牛顿* OR option_a:牛顿* OR analysis:牛顿*) QStringList matchParts; for (const QString col : columns) { matchParts QString(%1:%2).arg(col, ftsKeyword); } return ( matchParts.join( OR ) ); } // 调用示例 QSqlQuery query(db); query.prepare(SELECT id FROM questions_fts WHERE questions_fts MATCH ?); query.addBindValue(buildFtsQuery(牛顿, SearchScope::All)); query.exec();这里有个易踩坑点不要用keyword *直接拼 SQL。如果用户搜“C”C*会被 FTS5 解析为语法错误是运算符。正确做法是先对keyword做转义keyword.replace(, \\).replace(-, \\-)...源码中utils/StringHelper.cpp的escapeFtsKeyword()函数已实现此逻辑。4. 运行与调试从零开始跑通避开新手必踩的 5 个坑别急着编译先确认环境。这个项目基于 Qt 5.15.2LTS 版本最低要求 Qt 5.12。以下步骤在 Windows 10/11、Ubuntu 20.04、macOS 12 上均验证通过。4.1 编译前必做三件事确认 Qt 安装路径已加入系统 PATHWindows 下检查qmake -v是否输出版本macOS/Linux 下确保which qmake返回/Users/xxx/Qt/5.15.2/clang_64/bin/qmake类似路径。若未配置Qt Creator 会报“Cannot find qmake”而非“找不到 Qt”。安装 QXlsx 依赖Excel 导入导出必需项目使用第三方库 QXlsx 不能通过apt install或brew install安装。必须下载 QXlsx 源码Release v1.4.9在 Qt Creator 中将QXlsx/src目录作为子项目添加右键项目 → Add Existing Directory修改ExamDB.pro在QT core gui后追加include(../QXlsx/src/QXlsx.pri)若跳过此步编译会卡在#include xlsxdocument.h报“no such file”。首次运行前清空残留数据库尤其从旧版本升级如果之前运行过测试版%APPDATA%\ExamDB\exam_db.sqlite可能结构不兼容。安全做法是关闭程序 → 重命名该文件为exam_db.sqlite.bak→ 再次运行程序会自动生成新库并初始化表结构。4.2 常见问题排查5 条真实翻车记录现象 1点击“搜索”无反应控制台输出QSqlQuery::exec: database not open原因QuestionDAO::instance()是单例但其内部QSqlDatabase db QSqlDatabase::database()在多线程下可能返回空连接。源码中QuestionDAO::initDatabase()仅在主线程调用而搜索可能在独立线程为防 UI 卡顿执行。解决在QuestionDAO::searchQuestions()开头强制获取连接QSqlDatabase db QSqlDatabase::database(); // 确保连接存在 if (!db.isOpen()) db.open(); // 若未打开则打开现象 2导入 Excel 后中文题干显示为乱码如“é误”原因Excel 文件本身编码为 UTF-8但QXlsx::Document默认按系统本地编码Windows 是 GBK读取。解决在utils/ExcelHelper.cpp的importFromXlsx()中读取单元格后强制转码QString cellText sheet-cellAt(row, col)-value().toString(); if (!cellText.isEmpty()) { // 强制按 UTF-8 解码即使 Excel 声称是 ANSI QByteArray utf8Bytes cellText.toLocal8Bit(); cellText QString::fromUtf8(utf8Bytes); }现象 3修改题目后“预览面板”不刷新仍显示旧内容原因MainWindow中的预览面板绑定的是QuestionTableModel的当前行数据但模型未收到dataChanged信号。QuestionDAO::saveQuestion()更新了数据库但没通知模型。解决在QuestionDAO::saveQuestion()成功后发出自定义信号emit dataUpdated(q.id); // 在 DAO 类中声明 signal并在MainWindow中连接connect(QuestionDAO::instance(), QuestionDAO::dataUpdated, this, MainWindow::onQuestionUpdated);onQuestionUpdated()中调用model-refreshRow(id)—— 源码中QuestionTableModel::refreshRow()会重新查询该 ID 的数据并触发dataChanged。现象 4在 macOS 上打包后双击图标无反应终端运行报dyld: Library not loaded: rpath/Qt5Core.framework/Versions/5/Qt5Core原因macOS 的动态库路径未重写。Qt Creator 的macdeployqt工具未正确执行。解决在 Qt Creator 构建设置中将“构建步骤”里的macdeployqt命令参数改为macdeployqt ExamDB.app -dmg -verbose2或手动执行cd build-ExamDB-Desktop_Qt_5_15_2_clang_64-Release macdeployqt ExamDB.app -dmg现象 5搜索“动能”时命中了“动能定理”但没命中“动能守恒”而用户期望后者也出现原因FTS5 默认分词器simple tokenizer按 Unicode 字符边界切分中文下“动能守恒”被分为“动”“能”“守”“恒”四个单字动能*无法匹配。解决启用unicode61分词器支持中文分词-- 删除旧 FTS 表会丢失索引但数据在主表 DROP TABLE questions_fts; -- 重建指定 tokenizer CREATE VIRTUAL TABLE questions_fts USING fts5( stem, option_a, option_b, option_c, option_d, analysis, contentquestions, content_rowidid, tokenizeunicode61 );提示unicode61是 SQLite 内置分词器无需额外编译启用后“动能守恒”会被视为一个 token动能*即可匹配。5. 二次开发实战给试题库加一个「智能推荐相似题」功能现在我们来做一个真正提升命题效率的改造当教师编辑某道题时右侧预览面板下方增加一个“相似题目推荐”区域自动列出与当前题干语义最接近的 5 道题。这不需要大模型用 SQLite 的fts5 余弦相似度即可实现全程在本地完成。5.1 设计思路用 TF-IDF 向量做轻量级语义匹配核心思想将每道题的题干、选项、解析拼接成一段文本用 FTS5 的bm25()函数计算其与目标题的“相关性分数”。SQLite 的bm25()是一个内置的排名函数它基于 TF-IDF词频-逆文档频率原理无需训练开箱即用。我们不追求 NLP 级别的语义理解只要求“同知识点、同表述风格”的题目排在前面。5.2 关键代码实现三步嵌入现有架构第一步扩展 FTS5 表添加 bm25 支持在QuestionDAO::initDatabase()中建表语句末尾追加-- 创建 FTS5 表时启用 bm25 CREATE VIRTUAL TABLE IF NOT EXISTS questions_fts USING fts5( stem, option_a, option_b, option_c, option_d, analysis, contentquestions, content_rowidid, tokenizeunicode61 ); -- 创建辅助表存储 bm25 排名SQLite 要求显式创建 CREATE TABLE IF NOT EXISTS questions_fts_config(c0, c1, c2, c3, c4, c5);第二步编写推荐查询方法在QuestionDAO.h中添加// 返回与 targetId 题目最相似的 topN 题目 ID 列表 static QListquint64 findSimilarQuestions(quint64 targetId, int topN 5);在QuestionDAO.cpp中实现QListquint64 QuestionDAO::findSimilarQuestions(quint64 targetId, int topN) { QSqlDatabase db QSqlDatabase::database(); QSqlQuery query(db); // 1. 先查出目标题的完整文本 query.prepare(SELECT stem, option_a, option_b, option_c, option_d, analysis FROM questions WHERE id ?); query.addBindValue(targetId); query.exec(); if (!query.next()) return {}; QString targetText query.value(stem).toString() query.value(option_a).toString() query.value(option_b).toString() query.value(option_c).toString() query.value(option_d).toString() query.value(analysis).toString(); // 2. 用 bm25 计算所有题与 targetText 的相关性排除自身 QString sql R( SELECT id FROM questions_fts WHERE questions_fts MATCH ? AND id ! ? ORDER BY bm25(questions_fts) ASC LIMIT ? ); query.prepare(sql); query.addBindValue(targetText *); // 用前缀匹配扩大召回 query.addBindValue(targetId); query.addBindValue(topN); query.exec(); QListquint64 result; while (query.next()) { result.append(query.value(0).toULongLong()); } return result; }第三步在 UI 层集成在MainWindow.cpp的onQuestionSelected()槽函数中当用户在表格中选中一行时触发添加// ... 原有预览逻辑 quint64 currentId model-data(model-index(row, 0), Qt::UserRole).toULongLong(); QListquint64 similarIds QuestionDAO::instance()-findSimilarQuestions(currentId); // 更新 UI将 similarIds 传给预览面板的 SimilarQuestionWidget ui-previewWidget-showSimilarQuestions(similarIds);SimilarQuestionWidget是一个新组件继承QWidget内部用QVBoxLayoutQListWidget显示题目 ID 和简短题干调用QuestionDAO::getQuestionById()获取。5.3 效果验证与调优技巧验证方法导入 1000 道高中物理题手动选中一道“关于斜面上物体受力分析”的题观察推荐列表是否集中出现“斜面”“摩擦力”“静止”“匀速下滑”等关键词的题目。调优点 1召回率若推荐太少将targetText *改为targetText.split( ).join(* ) *对每个词单独做前缀匹配。调优点 2精度若推荐太多无关题在ORDER BY后追加AND difficulty BETWEEN ? AND ?限定难度区间参数来自当前题的difficulty值 ±1。性能底线实测在 5000 题库中单次推荐查询耗时 150msSSD 磁盘完全满足交互实时性。从那以后我每次给教育类工具加推荐功能都强制走一遍“SQLite FTS5 bm25”路径——它不依赖 Python 环境不增加部署复杂度不引入外部服务所有逻辑都在一个.cpp文件里出了问题qDebug()打印 SQL 就能定位。比起调用一个黑匣子 API我更相信自己写的这几十行 SQL 和 C。希望帮到你。本文还有配套的精品资源点击获取
