简介这是一份面向高校计算机相关专业课程设计或毕业设计的图书管理系统完整方案基于Qt框架与SQL数据库实现适合具备C与数据库基础、希望快速搭建可演示项目或系统学习桌面应用开发的学习者。压缩包共一百三十二个文件约六点六七MB其中四十个头文件与二十四个源文件构成项目核心逻辑十八个界面文件用于可视化窗体设计并配有流程图、设计报告、界面截图、资源文件等便于在代码、界面与文档之间对照理解。系统区分管理员和普通用户两种角色覆盖图书入库、检索、借还、逾期统计等常用业务流还通过绘图组件展示运营数据整体功能完整、模块边界清晰。源码均经过本地编译验证按照文档配置数据库和开发环境即可直接运行能帮助节省大量排错时间。目前已有二百二十一人学习下载无论是用于课程设计答辩、综合实训还是作为Qt与数据库结合开发的入门范本都具有较好的借鉴意义。1. 图书管理系统为什么值得选 QT 来做图书管理系统几乎是 QT 课程设计里出现频率最高的题目之一但它的坑不在界面控件而在“登录后怎么按角色切换模块、借还书怎么保证数据库一致、统计图怎么不卡界面”这三件事上。这套资源恰好覆盖了完整链路mainwindow.cpp 负责登录和主框架admin/user 两个窗口分别处理管理员和普通用户业务paint.cpp 封装图表绘制qcustomplot.cpp 直接以源码形式提供绘图能力再配合 SQLite 和配套文档能当作一份可运行、可交差的课设模板。适合正在选型 C/Qt 课设的同学也适合想快速翻一下 Qt Widgets 业务分层写法的从业者参考后面我按文件结构、数据事务、图表绘制、打包排错四个角度拆开讲。2. 源码结构拆解mainwindow 与 admin/user 的职责边界这套源码从文件命名就能看出典型的 Qt Widgets 单窗口单类风格不是把所有功能塞进 mainwindow.cpp而是按角色拆成管理员端和用户端。对课程设计来说这种拆分的好处是评审老师问“某个功能在哪”时你能直接指出文件而不是在一千行的主窗口里翻按钮的 connect 所在行。2.1 从 .cpp 文件名还原模块划分拿到压缩包先不要急着编译按文件列表过一遍基本能还原作者的设计意图文件对应模块主要职责mainwindow.cpp登录窗口与主框架登录验证、角色判定、页面切换adiminster.cpp管理员端图书增删改查、读者管理、借阅记录维护user.cpp普通用户端书目检索、借书、还书、个人借阅历史paint.cpp图表封装把 SQL 统计结果转成 QCustomPlot 数据并刷新qcustomplot.cpp第三方绘图库QCustomPlot 全部实现随源码一并编译源码里管理员窗口的文件名是 adiminster.cpp这个拼写不算标准编译运行没问题但如果你要交报告建议在类名里用 AdminWindow并在文档里注明文件名对应关系避免答辩时被问住。qcustomplot.cpp 是第三方开源库体积不小但也正因为它是单文件源码不需要额外装模块放到工程里加进 .pro 的 SOURCES 就能编。2.2 登录后的页面切换QStackedWidget 比反复 new 窗口更顺很多课设喜欢登录成功之后 loginWindow-hide()再 new 一个 AdminWindow 出来 show()。这样做的缺点是每次登录都要重新初始化一次界面而且两个窗口各自持有数据库连接状态逻辑容易散。常见做法是 MainWindow 里放一个 QStackedWidget把登录页、管理员页、用户页都预先加进去登录成功后直接切页。// mainwindow.cpp 构造函数中完成页面注册 stackWidget new QStackedWidget(this); stackWidget-addWidget(loginPage); // index 0 stackWidget-addWidget(adminPage); // index 1 stackWidget-addWidget(userPage); // index 2 // 登录成功后由信号槽触发切换 connect(loginPage, LoginWidget::loginSucceeded, this, MainWindow::onLoginSucceeded); void MainWindow::onLoginSucceeded(int role, const QString userId) { if (role 1) { stackWidget-setCurrentWidget(adminPage); adminPage-setCurrentUser(userId); } else { stackWidget-setCurrentWidget(userPage); userPage-setCurrentUser(userId); } }这段代码把页面切换收敛到 MainWindow 一个地方。role 为 1 表示管理员其他值走用户端setCurrentUser 负责把登录者的 id 传给业务页面后续查询“我借了哪些书”都依赖这个成员变量。相比反复 new 窗口QStackedWidget 的优势是切页不重建界面表格筛选条件、图表缩放状态都能保留。2.3 管理员端用 QSqlTableModel 绑表避免逐行 setText图书管理界面最忌讳的是用 QTableWidget 手动 setItem 填充数据一旦图书数量上千刷新就会明显卡顿而且增删改之后还要自己同步 UI。课设能接受的写法是 QSqlTableModel 直接绑表配合 QTableView 显示。bookModel new QSqlTableModel(this); bookModel-setTable(books); bookModel-setEditStrategy(QSqlTableModel::OnManualSubmit); bookModel-setHeaderData(1, Qt::Horizontal, QStringLiteral(书名)); bookModel-setHeaderData(2, Qt::Horizontal, QStringLiteral(作者)); ui-tableView-setModel(bookModel); bookModel-select();setEditStrategy 用 OnManualSubmit 的意思是界面上改了单元格不会立刻写库必须手动调用 submitAll() 才生效这样可以避免用户误操作直接污染数据。删除时先 removeRows再统一 submitAll()如果要取消修改调用 revertAll() 就能回到上次提交状态。user.cpp 里查“我的借阅记录”也用同样的套路只是 setTable 换成 borrow_records再用 setFilter 限定 user_id。2.4 共享当前登录用户成员变量比全局变量稳有些不成熟的课设会把当前用户 id 存成 static 全局变量表面省事但多窗口环境下排查问题很痛苦。更合理的做法是给每个页面提供一个 setCurrentUser 接口把登录信息作为成员变量缓存。void AdminWindow::setCurrentUser(const QString userId) { currentUserId userId; // 刷新该用户相关的审批、借阅记录 refreshBorrowList(); }2.5 模块之间通信尽量走信号槽adminPage 要通知 MainWindow“退出登录”不要直接操作 stackWidget 的索引而是发一个 logoutRequested 信号由 MainWindow 决定切回登录页并清理密码框缓存。这样每个页面只关心自己该做什么页面之间的耦合降到最低后续如果要加“修改密码后强制重新登录”之类的功能也只要在 MainWindow 里多接一个信号。3. 数据层设计借书事务和 QSqlQuery 的边界图书管理系统无论界面怎么写最终比拼的是数据不丢、不错、不乱。课设里的常见扣分点集中在还书日期超出 30 天怎么算逾期、库存为 0 时还能不能借出、连续借两本书会不会把库存扣成负数。这三个问题的解法都指向表结构设计和事务控制。3.1 三张表的字段设计常规课设最少需要三张表读者表、图书表、借阅记录表。注意借阅记录表不直接放“读者姓名”和“书名”而是放 id 外键这样改书名或改读者姓名时不需要动历史记录。表名关键字段说明usersuser_id, username, password, roleuser_id 用学号/工号字符串role 区分管理员booksbook_id, title, author, publisher, category, stock, locationstock 是剩余可借数量borrow_recordsrecord_id, book_id, user_id, borrow_date, due_date, return_date, statusstatus: 0 借出中1 已归还users 表里如果直接用自增 int 而不是字符串 id后面做“某读者借过多少本”统计时还得 join反而麻烦。borrow_records 的 due_date 在插入记录时直接用 SQLite 的 date(now, 30 days) 生成减少 C 端日期格式化代码。3.2 连接数据库前先检查驱动项目文档里说配置好环境就能运行最常见的环境问题就是 QSQLITE 驱动没加载。Qt 的 SQLite 插件编译后是一个 sqldrivers 文件夹下的 dll如果程序报错 “QSqlDatabase: QSQLITE driver not loaded”通常不是代码问题而是插件目录缺失或程序运行目录不对。if (!QSqlDatabase::isDriverAvailable(QSQLITE)) { QMessageBox::critical(nullptr, QStringLiteral(错误), QStringLiteral(未找到 QSQLITE 驱动请检查 sqldrivers 目录)); return; } QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE); db.setDatabaseName(library.db); if (!db.open()) { qDebug() db.lastError().text(); }这里是先判断驱动存在再创建连接。addDatabase 的第二个参数可以传连接名如果你在管理员端和用户端各开一个连接务必使用不同的连接名比如 addDatabase(QSQLITE, adminConn)否则第二次 addDatabase 默认覆盖第一次连接导致第一个窗口查询全部失败。3.3 借书流程用事务包起来借书看起来是“插一条记录、减一个库存”但实际上两个 SQL 必须要么都成功要么都失败。如果插了借阅记录但库存没减书就“凭空消失”了如果减了库存但记录没插上读者会莫名少一本书。正确做法是把两步放进一个事务。// 借书槽函数 if (!db.transaction()) return; QSqlQuery check(db); check.prepare(SELECT stock FROM books WHERE book_id ?); check.addBindValue(bookId); if (!check.exec() || !check.next() || check.value(0).toInt() 0) { db.rollback(); QMessageBox::warning(this, QStringLiteral(提示), QStringLiteral(该图书已无可借库存)); return; } QSqlQuery insert(db); insert.prepare(INSERT INTO borrow_records(book_id, user_id, borrow_date, due_date, status) VALUES(?, ?, date(now), date(now, 30 days), 0)); insert.addBindValue(bookId); insert.addBindValue(currentUserId); if (!insert.exec()) { db.rollback(); return; } QSqlQuery update(db); update.prepare(UPDATE books SET stock stock - 1 WHERE book_id ?); update.addBindValue(bookId); if (!update.exec()) { db.rollback(); return; } db.commit(); refreshBookTable();注意这里的事务边界先 check 库存再 insert 借阅记录最后 update 库存。任何一个 exec 失败都直接 rollback不会留下半截状态。addBindValue 的作用是参数绑定比拼接字符串多一层安全保护书名里带单引号也不会破坏 SQL。SQLite 单机场景下事务粒度不建议开得太大一次借书一个事务就够了。3.4 关键词检索的 LIKE 过滤怎么防注入QSqlTableModel 没有 prepare 接口setFilter 拼字符串时最容易踩的坑是书名里含单引号比如 “SQLS 入门”一个未转义的单引号会让整条查询失败。QString keyword ui-editKeyword-text().trimmed(); keyword keyword.replace(, ); bookModel-setFilter(QString(title LIKE %%1% OR author LIKE %%1%) .arg(keyword)); bookModel-select();replace(, ) 是 SQL 标准里的转义写法两个单引号代表一个字面单引号。LIKE 后面那两个 % 是通配符其中 %1 会被 arg 替换成用户输入首尾的 % 表示“包含关系”。如果只写一半检索逻辑就从包含变成前缀或后缀匹配容易得出与预期不符的结果。4. QCustomPlot 实战paint.cpp 里的统计图怎么画管理端除了表格评审老师通常还想看到“界面有点可视化”比如月度借阅量柱状图、热门图书排行。这套资源里放 qcustomplot.cpp 而不是用 Qt Charts原因很直接Qt Charts 在 Qt 5 里需要通过 QT charts 单独添加模块发布时还牵扯插件的额外拷贝QCustomPlot 只需要把 .cpp 和 .h 放进工程所有绘制能力都在你的程序里。4.1 paint.cpp 的定位隔离绘图逻辑paint.cpp 在这个项目里建议只做一件事接收 SQL 查出来的统计结果转换成 QCustomPlot 需要的 QVector 数据然后触发重绘。不要在 paint.cpp 里写 SQL也不要在查询函数里直接操作 plot 控件这样图表和业务数据可以各自单独测试。4.2 月度借阅量柱状图先看 SQL 端怎么取数。借阅日期是字符串格式形如 2025-01-15用 substr 截取前 7 位就能得到月份SELECT substr(borrow_date, 1, 7) AS month, COUNT(*) AS cnt FROM borrow_records GROUP BY month ORDER BY month;C 端拿到查询结果后填充 QCPBars这是 QCustomPlot 里的柱状图 plottable一组柱子对应一个 QCPBars 对象。// paint.cpp 中绘制柱状图 QCustomPlot *plot ui-widgetPlot; // UI 里放的 QCustomPlot 控件 QVectordouble ticks, counts; QStringList labels; QSqlQuery q(SELECT substr(borrow_date, 1, 7) AS month, COUNT(*) FROM borrow_records GROUP BY month ORDER BY month); while (q.next()) { labels q.value(0).toString(); ticks ticks.size(); // 0,1,2... counts q.value(1).toDouble(); } QSharedPointerQCPAxisTickerText textTicker(new QCPAxisTickerText); textTicker-setTicks(ticks, labels); plot-xAxis-setTicker(textTicker); plot-yAxis-setLabel(QStringLiteral(借阅数量)); QCPBars *bars new QCPBars(plot-xAxis, plot-yAxis); bars-setData(ticks, counts); bars-setPen(Qt::NoPen); bars-setBrush(QColor(70, 130, 180, 180)); plot-rescaleAxes(); plot-replot();这里 x 轴不能直接拿月份字符串当数值而是用 0、1、2 这样的整数刻度再把月份文本映射到刻度上否则月份文本会被当成普通分类坐标处理。setPen 设为 NoPen 是去掉柱子描边setBrush 里的第四个参数是 alpha 透明度能让重叠色块更好看。rescaleAxes 会根据当前数据自动调整坐标范围避免柱子跑到绘图区外面。4.3 热门图书 TOP10 排行借阅排行和月度统计共用同一套 QCPBars 逻辑区别只在 SQLSELECT b.title, COUNT(r.record_id) AS borrow_count FROM borrow_records r JOIN books b ON r.book_id b.book_id GROUP BY b.book_id ORDER BY borrow_count DESC LIMIT 10;图书管理系统这类数据量不大的课设用 GROUP BY 和 LIMIT 就够没必要在 C 端做排序。但有个细节需要注意QCPBars 的柱子宽度默认是按数据点数量自动算的如果你的数据只有五条柱子会非常宽建议显式设置 bars-setWidth(0.6 或 0.8) 控制比例。4.4 图表刷新与内存释放刷新图表时最容易犯的错误是每次查询都 new 一个 QCPBars旧对象一直保留在 plot 里导致刷新越多次、柱子越密集。正确做法是复用已有的 QCPBarsif (!bars) { bars new QCPBars(plot-xAxis, plot-yAxis); } else { bars-data()-clear(); } bars-setData(ticks, counts); plot-replot(QCustomPlot::rpQueuedRepaint);data()-clear() 只清空柱子数据不销毁 plottable。replot 的参数 rpQueuedRepaint 表示延迟到事件循环空闲时重绘连续刷新多组数据时能减少闪烁。QCustomPlot 在数据量几千点以内的重绘开销都很小课设的图书数据不涉及性能瓶颈真正要避免的是反复 new 对象造成的内存泄漏。QCustomPlot 方法作用使用场景replot()立即重绘回调、按钮触发replot(QCustomPlot::rpQueuedRepaint)延迟重绘高频刷新、拖动条联动rescaleAxes()按数据重新缩放坐标轴数据范围变化后data()-clear()清空 plottable 数据复用柱状图刷新5. 发布、打包与排错从源码到绿色版本很多课设源码在开发机上跑得好好的拷到别的电脑双击 exe 就报“缺少 DLL”或者“QT_QPA_PLATFORM_PLUGIN_PATH not set”。这通常是构建版本和运行环境没对齐不是代码逻辑问题。5.1 环境不一致的典型报错报错找不到 msvcp140.dll程序是 MSVC 编译器构建的目标机器没有安装 VC 运行库。报错无法定位程序输入点你用了高版本 Qt 构建目标机器跑的是旧版本核心 DLL程序路径里混入了别处的 qt*.dll。报错 QT_QPA_PLATFORM_PLUGIN_PATH程序没找到 platforms/qwindows.dll 平台插件通常发生在用 Qt Creator 直接拷贝 exe 而未做部署时。用 windeployqt 可以一次性补齐 Qt 运行库cd /d D:\build\LibrarySystem\release set PATHC:\Qt\5.15.2\msvc2019_64\bin;%PATH% windeployqt LibrarySystem.exe第一条命令切到 release 构建目录注意必须是 releasedebug 版带调试符号且体积大得多。第二条把 Qt 的 bin 目录临时加进 PATH目的是让 windeployqt 能定位到同版本的 Qt 库。第三条执行后工具会自动把 exe 依赖的 Qt5Core.dll、Qt5Widgets.dll、platforms 插件等全部复制到当前目录。5.2 打包前把数据库路径改为自动定位课设里 setDatabaseName(library.db) 用的相对路径开发时没有“当前目录”概念因为 exe 在 build 目录源程序里也能通过绝对路径连接。但发布之后如果把程序安装在 D 盘library.db 就会被放下 D:\LibrarySystem 下把程序拷到 U 盘给别人运行当前目录可能是任意盘符。更稳的课设做法是把数据库放到 QStandardPaths 指定的用户数据目录QString dataDir QStandardPaths::writableLocation(QStandardPaths::AppDataLocation); QDir().mkpath(dataDir); QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE); db.setDatabaseName(dataDir /library.db);AppDataLocation 在 Windows 上会落到 C:/Users/用户名/AppData/Roaming/程序名 下首次运行自动创建目录避免“无法打开数据库文件”的权限类问题。如果你的课设报告里想体现 QT 国际化能力还可以在 main.cpp 里用 QTranslator 加载 .qm 文件配合 QStringLiteral 标记需要翻译的文本但这部分作为加分项即可先把运行环境和数据库路径稳定下来更有价值。本文还有配套的精品资源点击获取 
长河君 · 2026/9/14 6:22:46 · 阅读 1.2k Qt图书管理系统课设全解析：界面分层、SQLite事务与QCustomPlot绘图实战
简介这是一份面向高校计算机相关专业课程设计或毕业设计的图书管理系统完整方案基于Qt框架与SQL数据库实现适合具备C与数据库基础、希望快速搭建可演示项目或系统学习桌面应用开发的学习者。压缩包共一百三十二个文件约六点六七MB其中四十个头文件与二十四个源文件构成项目核心逻辑十八个界面文件用于可视化窗体设计并配有流程图、设计报告、界面截图、资源文件等便于在代码、界面与文档之间对照理解。系统区分管理员和普通用户两种角色覆盖图书入库、检索、借还、逾期统计等常用业务流还通过绘图组件展示运营数据整体功能完整、模块边界清晰。源码均经过本地编译验证按照文档配置数据库和开发环境即可直接运行能帮助节省大量排错时间。目前已有二百二十一人学习下载无论是用于课程设计答辩、综合实训还是作为Qt与数据库结合开发的入门范本都具有较好的借鉴意义。1. 图书管理系统为什么值得选 QT 来做图书管理系统几乎是 QT 课程设计里出现频率最高的题目之一但它的坑不在界面控件而在“登录后怎么按角色切换模块、借还书怎么保证数据库一致、统计图怎么不卡界面”这三件事上。这套资源恰好覆盖了完整链路mainwindow.cpp 负责登录和主框架admin/user 两个窗口分别处理管理员和普通用户业务paint.cpp 封装图表绘制qcustomplot.cpp 直接以源码形式提供绘图能力再配合 SQLite 和配套文档能当作一份可运行、可交差的课设模板。适合正在选型 C/Qt 课设的同学也适合想快速翻一下 Qt Widgets 业务分层写法的从业者参考后面我按文件结构、数据事务、图表绘制、打包排错四个角度拆开讲。2. 源码结构拆解mainwindow 与 admin/user 的职责边界这套源码从文件命名就能看出典型的 Qt Widgets 单窗口单类风格不是把所有功能塞进 mainwindow.cpp而是按角色拆成管理员端和用户端。对课程设计来说这种拆分的好处是评审老师问“某个功能在哪”时你能直接指出文件而不是在一千行的主窗口里翻按钮的 connect 所在行。2.1 从 .cpp 文件名还原模块划分拿到压缩包先不要急着编译按文件列表过一遍基本能还原作者的设计意图文件对应模块主要职责mainwindow.cpp登录窗口与主框架登录验证、角色判定、页面切换adiminster.cpp管理员端图书增删改查、读者管理、借阅记录维护user.cpp普通用户端书目检索、借书、还书、个人借阅历史paint.cpp图表封装把 SQL 统计结果转成 QCustomPlot 数据并刷新qcustomplot.cpp第三方绘图库QCustomPlot 全部实现随源码一并编译源码里管理员窗口的文件名是 adiminster.cpp这个拼写不算标准编译运行没问题但如果你要交报告建议在类名里用 AdminWindow并在文档里注明文件名对应关系避免答辩时被问住。qcustomplot.cpp 是第三方开源库体积不小但也正因为它是单文件源码不需要额外装模块放到工程里加进 .pro 的 SOURCES 就能编。2.2 登录后的页面切换QStackedWidget 比反复 new 窗口更顺很多课设喜欢登录成功之后 loginWindow-hide()再 new 一个 AdminWindow 出来 show()。这样做的缺点是每次登录都要重新初始化一次界面而且两个窗口各自持有数据库连接状态逻辑容易散。常见做法是 MainWindow 里放一个 QStackedWidget把登录页、管理员页、用户页都预先加进去登录成功后直接切页。// mainwindow.cpp 构造函数中完成页面注册 stackWidget new QStackedWidget(this); stackWidget-addWidget(loginPage); // index 0 stackWidget-addWidget(adminPage); // index 1 stackWidget-addWidget(userPage); // index 2 // 登录成功后由信号槽触发切换 connect(loginPage, LoginWidget::loginSucceeded, this, MainWindow::onLoginSucceeded); void MainWindow::onLoginSucceeded(int role, const QString userId) { if (role 1) { stackWidget-setCurrentWidget(adminPage); adminPage-setCurrentUser(userId); } else { stackWidget-setCurrentWidget(userPage); userPage-setCurrentUser(userId); } }这段代码把页面切换收敛到 MainWindow 一个地方。role 为 1 表示管理员其他值走用户端setCurrentUser 负责把登录者的 id 传给业务页面后续查询“我借了哪些书”都依赖这个成员变量。相比反复 new 窗口QStackedWidget 的优势是切页不重建界面表格筛选条件、图表缩放状态都能保留。2.3 管理员端用 QSqlTableModel 绑表避免逐行 setText图书管理界面最忌讳的是用 QTableWidget 手动 setItem 填充数据一旦图书数量上千刷新就会明显卡顿而且增删改之后还要自己同步 UI。课设能接受的写法是 QSqlTableModel 直接绑表配合 QTableView 显示。bookModel new QSqlTableModel(this); bookModel-setTable(books); bookModel-setEditStrategy(QSqlTableModel::OnManualSubmit); bookModel-setHeaderData(1, Qt::Horizontal, QStringLiteral(书名)); bookModel-setHeaderData(2, Qt::Horizontal, QStringLiteral(作者)); ui-tableView-setModel(bookModel); bookModel-select();setEditStrategy 用 OnManualSubmit 的意思是界面上改了单元格不会立刻写库必须手动调用 submitAll() 才生效这样可以避免用户误操作直接污染数据。删除时先 removeRows再统一 submitAll()如果要取消修改调用 revertAll() 就能回到上次提交状态。user.cpp 里查“我的借阅记录”也用同样的套路只是 setTable 换成 borrow_records再用 setFilter 限定 user_id。2.4 共享当前登录用户成员变量比全局变量稳有些不成熟的课设会把当前用户 id 存成 static 全局变量表面省事但多窗口环境下排查问题很痛苦。更合理的做法是给每个页面提供一个 setCurrentUser 接口把登录信息作为成员变量缓存。void AdminWindow::setCurrentUser(const QString userId) { currentUserId userId; // 刷新该用户相关的审批、借阅记录 refreshBorrowList(); }2.5 模块之间通信尽量走信号槽adminPage 要通知 MainWindow“退出登录”不要直接操作 stackWidget 的索引而是发一个 logoutRequested 信号由 MainWindow 决定切回登录页并清理密码框缓存。这样每个页面只关心自己该做什么页面之间的耦合降到最低后续如果要加“修改密码后强制重新登录”之类的功能也只要在 MainWindow 里多接一个信号。3. 数据层设计借书事务和 QSqlQuery 的边界图书管理系统无论界面怎么写最终比拼的是数据不丢、不错、不乱。课设里的常见扣分点集中在还书日期超出 30 天怎么算逾期、库存为 0 时还能不能借出、连续借两本书会不会把库存扣成负数。这三个问题的解法都指向表结构设计和事务控制。3.1 三张表的字段设计常规课设最少需要三张表读者表、图书表、借阅记录表。注意借阅记录表不直接放“读者姓名”和“书名”而是放 id 外键这样改书名或改读者姓名时不需要动历史记录。表名关键字段说明usersuser_id, username, password, roleuser_id 用学号/工号字符串role 区分管理员booksbook_id, title, author, publisher, category, stock, locationstock 是剩余可借数量borrow_recordsrecord_id, book_id, user_id, borrow_date, due_date, return_date, statusstatus: 0 借出中1 已归还users 表里如果直接用自增 int 而不是字符串 id后面做“某读者借过多少本”统计时还得 join反而麻烦。borrow_records 的 due_date 在插入记录时直接用 SQLite 的 date(now, 30 days) 生成减少 C 端日期格式化代码。3.2 连接数据库前先检查驱动项目文档里说配置好环境就能运行最常见的环境问题就是 QSQLITE 驱动没加载。Qt 的 SQLite 插件编译后是一个 sqldrivers 文件夹下的 dll如果程序报错 “QSqlDatabase: QSQLITE driver not loaded”通常不是代码问题而是插件目录缺失或程序运行目录不对。if (!QSqlDatabase::isDriverAvailable(QSQLITE)) { QMessageBox::critical(nullptr, QStringLiteral(错误), QStringLiteral(未找到 QSQLITE 驱动请检查 sqldrivers 目录)); return; } QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE); db.setDatabaseName(library.db); if (!db.open()) { qDebug() db.lastError().text(); }这里是先判断驱动存在再创建连接。addDatabase 的第二个参数可以传连接名如果你在管理员端和用户端各开一个连接务必使用不同的连接名比如 addDatabase(QSQLITE, adminConn)否则第二次 addDatabase 默认覆盖第一次连接导致第一个窗口查询全部失败。3.3 借书流程用事务包起来借书看起来是“插一条记录、减一个库存”但实际上两个 SQL 必须要么都成功要么都失败。如果插了借阅记录但库存没减书就“凭空消失”了如果减了库存但记录没插上读者会莫名少一本书。正确做法是把两步放进一个事务。// 借书槽函数 if (!db.transaction()) return; QSqlQuery check(db); check.prepare(SELECT stock FROM books WHERE book_id ?); check.addBindValue(bookId); if (!check.exec() || !check.next() || check.value(0).toInt() 0) { db.rollback(); QMessageBox::warning(this, QStringLiteral(提示), QStringLiteral(该图书已无可借库存)); return; } QSqlQuery insert(db); insert.prepare(INSERT INTO borrow_records(book_id, user_id, borrow_date, due_date, status) VALUES(?, ?, date(now), date(now, 30 days), 0)); insert.addBindValue(bookId); insert.addBindValue(currentUserId); if (!insert.exec()) { db.rollback(); return; } QSqlQuery update(db); update.prepare(UPDATE books SET stock stock - 1 WHERE book_id ?); update.addBindValue(bookId); if (!update.exec()) { db.rollback(); return; } db.commit(); refreshBookTable();注意这里的事务边界先 check 库存再 insert 借阅记录最后 update 库存。任何一个 exec 失败都直接 rollback不会留下半截状态。addBindValue 的作用是参数绑定比拼接字符串多一层安全保护书名里带单引号也不会破坏 SQL。SQLite 单机场景下事务粒度不建议开得太大一次借书一个事务就够了。3.4 关键词检索的 LIKE 过滤怎么防注入QSqlTableModel 没有 prepare 接口setFilter 拼字符串时最容易踩的坑是书名里含单引号比如 “SQLS 入门”一个未转义的单引号会让整条查询失败。QString keyword ui-editKeyword-text().trimmed(); keyword keyword.replace(, ); bookModel-setFilter(QString(title LIKE %%1% OR author LIKE %%1%) .arg(keyword)); bookModel-select();replace(, ) 是 SQL 标准里的转义写法两个单引号代表一个字面单引号。LIKE 后面那两个 % 是通配符其中 %1 会被 arg 替换成用户输入首尾的 % 表示“包含关系”。如果只写一半检索逻辑就从包含变成前缀或后缀匹配容易得出与预期不符的结果。4. QCustomPlot 实战paint.cpp 里的统计图怎么画管理端除了表格评审老师通常还想看到“界面有点可视化”比如月度借阅量柱状图、热门图书排行。这套资源里放 qcustomplot.cpp 而不是用 Qt Charts原因很直接Qt Charts 在 Qt 5 里需要通过 QT charts 单独添加模块发布时还牵扯插件的额外拷贝QCustomPlot 只需要把 .cpp 和 .h 放进工程所有绘制能力都在你的程序里。4.1 paint.cpp 的定位隔离绘图逻辑paint.cpp 在这个项目里建议只做一件事接收 SQL 查出来的统计结果转换成 QCustomPlot 需要的 QVector 数据然后触发重绘。不要在 paint.cpp 里写 SQL也不要在查询函数里直接操作 plot 控件这样图表和业务数据可以各自单独测试。4.2 月度借阅量柱状图先看 SQL 端怎么取数。借阅日期是字符串格式形如 2025-01-15用 substr 截取前 7 位就能得到月份SELECT substr(borrow_date, 1, 7) AS month, COUNT(*) AS cnt FROM borrow_records GROUP BY month ORDER BY month;C 端拿到查询结果后填充 QCPBars这是 QCustomPlot 里的柱状图 plottable一组柱子对应一个 QCPBars 对象。// paint.cpp 中绘制柱状图 QCustomPlot *plot ui-widgetPlot; // UI 里放的 QCustomPlot 控件 QVectordouble ticks, counts; QStringList labels; QSqlQuery q(SELECT substr(borrow_date, 1, 7) AS month, COUNT(*) FROM borrow_records GROUP BY month ORDER BY month); while (q.next()) { labels q.value(0).toString(); ticks ticks.size(); // 0,1,2... counts q.value(1).toDouble(); } QSharedPointerQCPAxisTickerText textTicker(new QCPAxisTickerText); textTicker-setTicks(ticks, labels); plot-xAxis-setTicker(textTicker); plot-yAxis-setLabel(QStringLiteral(借阅数量)); QCPBars *bars new QCPBars(plot-xAxis, plot-yAxis); bars-setData(ticks, counts); bars-setPen(Qt::NoPen); bars-setBrush(QColor(70, 130, 180, 180)); plot-rescaleAxes(); plot-replot();这里 x 轴不能直接拿月份字符串当数值而是用 0、1、2 这样的整数刻度再把月份文本映射到刻度上否则月份文本会被当成普通分类坐标处理。setPen 设为 NoPen 是去掉柱子描边setBrush 里的第四个参数是 alpha 透明度能让重叠色块更好看。rescaleAxes 会根据当前数据自动调整坐标范围避免柱子跑到绘图区外面。4.3 热门图书 TOP10 排行借阅排行和月度统计共用同一套 QCPBars 逻辑区别只在 SQLSELECT b.title, COUNT(r.record_id) AS borrow_count FROM borrow_records r JOIN books b ON r.book_id b.book_id GROUP BY b.book_id ORDER BY borrow_count DESC LIMIT 10;图书管理系统这类数据量不大的课设用 GROUP BY 和 LIMIT 就够没必要在 C 端做排序。但有个细节需要注意QCPBars 的柱子宽度默认是按数据点数量自动算的如果你的数据只有五条柱子会非常宽建议显式设置 bars-setWidth(0.6 或 0.8) 控制比例。4.4 图表刷新与内存释放刷新图表时最容易犯的错误是每次查询都 new 一个 QCPBars旧对象一直保留在 plot 里导致刷新越多次、柱子越密集。正确做法是复用已有的 QCPBarsif (!bars) { bars new QCPBars(plot-xAxis, plot-yAxis); } else { bars-data()-clear(); } bars-setData(ticks, counts); plot-replot(QCustomPlot::rpQueuedRepaint);data()-clear() 只清空柱子数据不销毁 plottable。replot 的参数 rpQueuedRepaint 表示延迟到事件循环空闲时重绘连续刷新多组数据时能减少闪烁。QCustomPlot 在数据量几千点以内的重绘开销都很小课设的图书数据不涉及性能瓶颈真正要避免的是反复 new 对象造成的内存泄漏。QCustomPlot 方法作用使用场景replot()立即重绘回调、按钮触发replot(QCustomPlot::rpQueuedRepaint)延迟重绘高频刷新、拖动条联动rescaleAxes()按数据重新缩放坐标轴数据范围变化后data()-clear()清空 plottable 数据复用柱状图刷新5. 发布、打包与排错从源码到绿色版本很多课设源码在开发机上跑得好好的拷到别的电脑双击 exe 就报“缺少 DLL”或者“QT_QPA_PLATFORM_PLUGIN_PATH not set”。这通常是构建版本和运行环境没对齐不是代码逻辑问题。5.1 环境不一致的典型报错报错找不到 msvcp140.dll程序是 MSVC 编译器构建的目标机器没有安装 VC 运行库。报错无法定位程序输入点你用了高版本 Qt 构建目标机器跑的是旧版本核心 DLL程序路径里混入了别处的 qt*.dll。报错 QT_QPA_PLATFORM_PLUGIN_PATH程序没找到 platforms/qwindows.dll 平台插件通常发生在用 Qt Creator 直接拷贝 exe 而未做部署时。用 windeployqt 可以一次性补齐 Qt 运行库cd /d D:\build\LibrarySystem\release set PATHC:\Qt\5.15.2\msvc2019_64\bin;%PATH% windeployqt LibrarySystem.exe第一条命令切到 release 构建目录注意必须是 releasedebug 版带调试符号且体积大得多。第二条把 Qt 的 bin 目录临时加进 PATH目的是让 windeployqt 能定位到同版本的 Qt 库。第三条执行后工具会自动把 exe 依赖的 Qt5Core.dll、Qt5Widgets.dll、platforms 插件等全部复制到当前目录。5.2 打包前把数据库路径改为自动定位课设里 setDatabaseName(library.db) 用的相对路径开发时没有“当前目录”概念因为 exe 在 build 目录源程序里也能通过绝对路径连接。但发布之后如果把程序安装在 D 盘library.db 就会被放下 D:\LibrarySystem 下把程序拷到 U 盘给别人运行当前目录可能是任意盘符。更稳的课设做法是把数据库放到 QStandardPaths 指定的用户数据目录QString dataDir QStandardPaths::writableLocation(QStandardPaths::AppDataLocation); QDir().mkpath(dataDir); QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE); db.setDatabaseName(dataDir /library.db);AppDataLocation 在 Windows 上会落到 C:/Users/用户名/AppData/Roaming/程序名 下首次运行自动创建目录避免“无法打开数据库文件”的权限类问题。如果你的课设报告里想体现 QT 国际化能力还可以在 main.cpp 里用 QTranslator 加载 .qm 文件配合 QStringLiteral 标记需要翻译的文本但这部分作为加分项即可先把运行环境和数据库路径稳定下来更有价值。本文还有配套的精品资源点击获取