首页/资讯中心/详情

C++课程设计实战：基于QT与SQLite的教室管理系统开发指南

C++课程设计实战：基于QT与SQLite的教室管理系统开发指南
📅 发布时间：2026/7/17 23:19:08

1. 项目概述与核心价值

最近在带学生做课程设计，发现很多同学对“C++课程设计：QT+SQL教室管理系统”这个题目既兴奋又迷茫。兴奋在于，这听起来是一个能写在简历上的“正经”项目；迷茫则在于，QT和SQL这两个庞然大物，加上C++本身，不知道从哪里下嘴。我自己当年也是从这个阶段过来的，深知一个清晰的实战路径有多重要。这个项目绝不仅仅是为了应付作业，它本质上是一个微型的企业级桌面应用开发演练，涵盖了从需求分析、UI设计、业务逻辑编码、数据库操作到最终打包发布的完整流程。掌握了它，你就相当于亲手搭建了一个软件开发的“最小可行产品”（MVP）模型，对理解客户端-服务器架构、数据持久化、事件驱动编程等核心概念有巨大帮助。

简单来说，这个系统要干的事，就是模拟学校教务部门对教室资源的管理。核心用户（比如教务员）通过一个图形界面（QT实现），能方便地完成对教室信息的增删改查（CRUD）、预约教室、查看预约状态等操作，而所有这些数据都安全、持久地存储在一个数据库（SQL实现）里。它麻雀虽小，五脏俱全，非常适合作为C++从语法学习迈向综合应用开发的桥梁。

2. 技术栈选型与环境搭建

为什么是QT+SQL？这不是随便选的组合，而是经过实践检验的“黄金搭档”。C++负责核心业务逻辑，性能强劲；QT作为跨平台的GUI框架，提供了极其丰富的控件和信号槽机制，让界面开发变得直观；SQL（这里通常指SQLite或MySQL）则负责数据的结构化存储和高效查询。这个组合能让你在巩固C++面向对象思想的同时，接触到现代软件工程的实际工具链。

2.1 开发环境配置详解

工欲善其事，必先利其器。一个顺手的开发环境能避免无数坑。

1. 编译器与构建工具对于Windows平台，首推使用MSVC（Microsoft Visual C++）编译器套件。最简单的方式是安装Visual Studio 2022 Community版，在安装时勾选“使用C++的桌面开发”工作负载，它会自动安装MSVC、Windows SDK等必备组件。即便你后续主要用其他编辑器，这个编译器也是基础。避免使用MinGW，除非你有特定跨平台需求，因为它在链接某些库时更容易出问题。

2. QT框架安装直接去QT官网下载在线安装器qt-unified-windows-x64-online.exe。安装时，关键步骤在于组件选择：

  • QT版本：对于学习和课程设计，选择QT 5.15.2 LTS（长期支持版）是最稳妥的。它足够稳定，社区资源丰富。不必追求最新的QT6，除非项目有特定需求。
  • 编译器：务必勾选与你安装的MSVC版本对应的组件，例如MSVC 2019 64-bit。这是QT能与你的编译器对话的关键。
  • 额外组件：勾选Qt Creator（官方IDE，对新手友好）和Sources（QT源码，方便调试时查看）。Qt Charts、Qt Data Visualization等视项目需要选择，教室管理系统一般用不上。

3. 数据库选择与配置对于课程设计级别的项目，SQLite是完美选择。它无需安装独立的数据库服务器，整个数据库就是一个.db或.sqlite文件，非常适合嵌入式或单机桌面应用。QT原生就通过QtSql模块提供了对SQLite的完美支持。 如果你想挑战一下，也可以安装MySQL或PostgreSQL，这能让你接触到客户端-服务器模式的数据库操作，但需要额外安装和配置数据库服务，复杂度会高一些。我建议初学者先从SQLite入手，把核心逻辑跑通。

4. 代码编辑器/IDE

  • Qt Creator：QT亲儿子，开箱即用，对QT项目支持最好，内置UI设计器、调试器，非常适合新手快速上手。配置简单，新建项目时选择正确的Kit（即编译器+QT版本组合）即可。
  • Visual Studio：功能强大，调试体验极佳。需要安装“QT VS Tools”插件，才能在VS内管理QT项目和使用UI设计器。适合喜欢VS生态或项目较复杂的同学。
  • VSCode：轻量灵活，通过安装C++、QT、CMake等插件也能配置出强大的环境。但这需要较强的动手能力，要自己配置CMakeLists.txt或qmake的构建任务、头文件路径等。不建议课程设计初期折腾，容易劝退。

实操心得：强烈建议课程设计新手直接使用Qt Creator + QT 5.15.2 MSVC + SQLite这个组合。它把环境配置的复杂度降到了最低，让你能把精力集中在编码和逻辑实现上。在Qt Creator中新建项目时，务必在“Kit Selection”那一步，选择你安装好的那个带有MSVC和QT版本的Kit，这是项目能成功编译运行的基石。

2.2 项目工程结构设计

在动手写代码前，花点时间规划一下工程目录，好的结构是成功的一半。一个清晰的QT项目目录通常如下：

ClassroomManager/ ├── ClassroomManager.pro # QMake项目文件（如果用CMake则是CMakeLists.txt） ├── main.cpp # 程序入口 ├── mainwindow.ui # 主窗口界面文件（XML格式，由Qt Designer编辑） ├── mainwindow.h # 主窗口头文件 ├── mainwindow.cpp # 主窗口实现文件 ├── database/ │ ├── databaseconnection.h # 数据库连接类声明 │ └── databaseconnection.cpp # 数据库连接类实现 ├── entities/ # 实体类（对应数据库表） │ ├── classroom.h/.cpp │ └── reservation.h/.cpp ├── widgets/ # 自定义控件或对话框 │ ├── classroomdialog.h/.cpp │ └── reservationdialog.h/.cpp └── resources/ # 资源文件（如图标、图片） └── images/

在ClassroomManager.pro文件中，你需要添加必要的模块依赖，这是很多人会忘记的一步：

QT += core gui sql widgets # 核心、GUI、SQL和控件模块 greaterThan(QT_MAJOR_VERSION, 4): QT += widgets # 兼容性语句 TARGET = ClassroomManager TEMPLATE = app SOURCES += ... # 源文件 HEADERS += ... # 头文件 FORMS += ... # UI文件

注意第一行QT += sql，这是让你的程序能够使用QSqlDatabase等数据库类的关键。

3. 数据库设计与核心业务逻辑

数据库是整个系统的“记忆中枢”，设计的好坏直接决定了程序是否健壮和高效。

3.1 数据库表结构规划

我们至少需要两张核心表：教室表和预约记录表。它们之间通过教室ID进行关联。

1. 教室表 (classroom)这张表存储教室的静态信息。

字段名数据类型约束说明
idINTEGERPRIMARY KEY AUTOINCREMENT主键，自增，唯一标识一间教室
room_numberVARCHAR(20)NOT NULL UNIQUE教室编号，如“A101”，必须唯一
buildingVARCHAR(50)NOT NULL所在楼栋，如“逸夫楼”
capacityINTEGERNOT NULL CHECK(capacity > 0)容纳人数
has_multimediaBOOLEANDEFAULT 0是否有多媒体设备（0否，1是）
descriptionTEXT备注信息

2. 预约记录表 (reservation)这张表记录动态的预约事件。

字段名数据类型约束说明
idINTEGERPRIMARY KEY AUTOINCREMENT预约记录ID
classroom_idINTEGERNOT NULL外键，关联classroom.id
applicantVARCHAR(100)NOT NULL申请人（如班级、社团、教师名）
purposeVARCHAR(200)NOT NULL使用用途
start_timeDATETIMENOT NULL预约开始时间
end_timeDATETIMENOT NULL预约结束时间
statusVARCHAR(20)DEFAULT 'pending'状态（pending审核中, approved已通过, rejected已拒绝）
FOREIGN KEY (classroom_id) REFERENCES classroom(id) ON DELETE CASCADE外键约束，删除教室时级联删除其预约

设计要点：start_time和end_time使用DATETIME类型，便于进行时间范围的查询和冲突检测。status字段为工作流预留了空间，简单的系统可以只有“已预约”，复杂的可以加入审核流程。

3.2 数据库连接与初始化封装

在QT中操作数据库，最佳实践是将其封装成一个单独的类，例如DatabaseConnection。这个类负责数据库的连接、关闭、以及执行一些通用的初始化SQL（建表）。

databaseconnection.h 关键部分：

#ifndef DATABASECONNECTION_H #define DATABASECONNECTION_H #include <QSqlDatabase> #include <QString> class DatabaseConnection { public: static DatabaseConnection& getInstance(); // 单例模式，全局一个连接 bool openConnection(const QString& dbPath = "classroom.db"); void closeConnection(); QSqlDatabase getDatabase() const; bool initDatabase(); // 初始化表结构 private: DatabaseConnection() = default; // 私有构造函数 QSqlDatabase m_db; }; #endif // DATABASECONNECTION_H

databaseconnection.cpp 中的连接与初始化：

#include "databaseconnection.h" #include <QSqlQuery> #include <QSqlError> #include <QDebug> #include <QFile> #include <QDir> DatabaseConnection& DatabaseConnection::getInstance() { static DatabaseConnection instance; return instance; } bool DatabaseConnection::openConnection(const QString& dbPath) { // 确保数据库文件所在目录存在 QFileInfo fileInfo(dbPath); QDir dir = fileInfo.dir(); if (!dir.exists()) { dir.mkpath("."); } m_db = QSqlDatabase::addDatabase("QSQLITE"); // 指定SQLite驱动 m_db.setDatabaseName(dbPath); if (!m_db.open()) { qDebug() << "Failed to open database:" << m_db.lastError().text(); return false; } qDebug() << "Database connected successfully."; return true; } bool DatabaseConnection::initDatabase() { QSqlQuery query(m_db); QStringList sqls; // 创建教室表 sqls << "CREATE TABLE IF NOT EXISTS classroom (" "id INTEGER PRIMARY KEY AUTOINCREMENT," "room_number VARCHAR(20) NOT NULL UNIQUE," "building VARCHAR(50) NOT NULL," "capacity INTEGER NOT NULL CHECK(capacity > 0)," "has_multimedia BOOLEAN DEFAULT 0," "description TEXT" ");"; // 创建预约表 sqls << "CREATE TABLE IF NOT EXISTS reservation (" "id INTEGER PRIMARY KEY AUTOINCREMENT," "classroom_id INTEGER NOT NULL," "applicant VARCHAR(100) NOT NULL," "purpose VARCHAR(200) NOT NULL," "start_time DATETIME NOT NULL," "end_time DATETIME NOT NULL," "status VARCHAR(20) DEFAULT 'pending'," "FOREIGN KEY (classroom_id) REFERENCES classroom(id) ON DELETE CASCADE" ");"; // 为预约表的教室ID和时间字段创建索引，大幅提升查询速度 sqls << "CREATE INDEX IF NOT EXISTS idx_reservation_classroom ON reservation(classroom_id);"; sqls << "CREATE INDEX IF NOT EXISTS idx_reservation_time ON reservation(start_time, end_time);"; for (const QString& sql : sqls) { if (!query.exec(sql)) { qDebug() << "Init database failed at SQL:" << sql; qDebug() << "Error:" << query.lastError().text(); return false; } } return true; }

避坑指南：

  1. 单例模式：桌面应用通常只需要一个全局数据库连接，单例模式可以避免重复连接和资源浪费。
  2. 路径处理：数据库文件路径最好使用相对路径或放在用户可写目录（如QStandardPaths::writableLocation(QStandardPaths::AppDataLocation)），避免因程序安装位置权限问题导致创建文件失败。
  3. 错误处理：每次执行SQL后，检查query.lastError()是必须的。将错误信息用qDebug()输出，是调试数据库问题时最直接的手段。
  4. 创建索引：reservation表会频繁按classroom_id和start_time/end_time查询（例如查某教室某时间段是否被占用）。为这些字段创建索引是至关重要的性能优化，能让查询速度提升几个数量级，数据量越大效果越明显。这是很多新手会忽略的一点。

4. QT界面设计与数据绑定

QT的强大之处在于其信号槽机制和Model/View架构，能让界面和数据逻辑优雅地解耦。

4.1 主界面布局与控件选择

使用Qt Designer拖拽生成mainwindow.ui。主界面可以设计为常见的“左侧导航树/列表，右侧详情与操作”布局。

  • 左侧：一个QListWidget或QTreeWidget，用于展示教室列表。
  • 右侧上部：一个QTableView，用于显示当前选中教室的预约记录。这是展示数据库数据的最佳控件。
  • 右侧下部：一系列按钮（QPushButton），如“新增教室”、“删除教室”、“预约教室”、“刷新”等，以及一些用于筛选的输入框（如QLineEdit用于搜索，QDateTimeEdit用于选择日期）。

关键是要为QTableView设置一个模型（Model）。我们将使用QSqlTableModel或QSqlQueryModel，它们能直接与数据库交互，自动处理数据的显示、排序和部分编辑。

4.2 使用Model-View架构展示数据

在mainwindow.cpp的初始化函数中，我们需要建立模型与视图的连接。

// mainwindow.cpp 构造函数或初始化函数中 #include "mainwindow.h" #include "ui_mainwindow.h" #include "databaseconnection.h" #include <QSqlTableModel> #include <QSqlQuery> #include <QMessageBox> MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , ui(new Ui::MainWindow) { ui->setupUi(this); // 1. 初始化数据库 DatabaseConnection& db = DatabaseConnection::getInstance(); if (!db.openConnection() || !db.initDatabase()) { QMessageBox::critical(this, "错误", "数据库初始化失败！"); return; } // 2. 创建教室列表的模型 (使用QSqlQueryModel，因为可能涉及复杂查询，如联表) m_classroomModel = new QSqlQueryModel(this); m_classroomModel->setQuery("SELECT id, room_number, building, capacity FROM classroom ORDER BY building, room_number"); ui->listViewClassroom->setModel(m_classroomModel); // 假设使用ListView ui->listViewClassroom->setModelColumn(1); // 显示room_number列 // 3. 创建预约记录表格的模型 (使用QSqlTableModel，方便过滤和编辑) m_reservationModel = new QSqlTableModel(this, db.getDatabase()); m_reservationModel->setTable("reservation"); m_reservationModel->setEditStrategy(QSqlTableModel::OnManualSubmit); // 手动提交修改 // 设置表头显示名称 m_reservationModel->setHeaderData(m_reservationModel->fieldIndex("applicant"), Qt::Horizontal, tr("申请人")); m_reservationModel->setHeaderData(m_reservationModel->fieldIndex("purpose"), Qt::Horizontal, tr("用途")); m_reservationModel->setHeaderData(m_reservationModel->fieldIndex("start_time"), Qt::Horizontal, tr("开始时间")); m_reservationModel->setHeaderData(m_reservationModel->fieldIndex("end_time"), Qt::Horizontal, tr("结束时间")); m_reservationModel->setHeaderData(m_reservationModel->fieldIndex("status"), Qt::Horizontal, tr("状态")); ui->tableViewReservation->setModel(m_reservationModel); ui->tableViewReservation->horizontalHeader()->setStretchLastSection(true); // 最后一列拉伸 // 4. 连接信号槽：当选中教室变化时，刷新右侧的预约表格 connect(ui->listViewClassroom->selectionModel(), &QItemSelectionModel::currentRowChanged, this, &MainWindow::onClassroomSelectionChanged); } void MainWindow::onClassroomSelectionChanged(const QModelIndex ¤t, const QModelIndex &previous) { Q_UNUSED(previous); if (!current.isValid()) { m_reservationModel->setFilter(""); // 清空筛选，显示所有？或者清空模型 m_reservationModel->select(); return; } // 获取选中教室的ID int classroomId = m_classroomModel->data(m_classroomModel->index(current.row(), 0)).toInt(); // 第0列是id // 设置过滤器，只显示该教室的预约记录 QString filter = QString("classroom_id = %1").arg(classroomId); m_reservationModel->setFilter(filter); m_reservationModel->select(); // 重新查询 }

核心技巧：

  • QSqlTableModel的setEditStrategy非常重要。OnManualSubmit意味着修改不会立即写入数据库，需要调用submitAll()。这给了我们做数据校验和撤销操作的机会。OnRowChange或OnFieldChange则是一修改就提交，风险较高。
  • 数据映射：表格直接显示外键classroom_id对用户不友好。更优的做法是重写QSqlTableModel的data()函数，或者使用QSqlRelationalTableModel，将classroom_id自动替换为room_number显示。这涉及到关系模型，是进阶内容，但能让用户体验提升一个档次。
  • 性能：QSqlTableModel在数据量很大（比如超过万行）时，一次性select()可能会卡顿。可以考虑使用QSqlQuery进行分页查询，或者使用QTableView的setIndexWidget等进行懒加载优化。对于课程设计规模，直接使用通常没问题。

4.3 实现增删改查对话框

“新增教室”、“预约教室”等功能，通常通过弹出对话框（QDialog）来实现。在Qt Designer中新建对话框.ui文件，设计好表单（QLineEdit、QSpinBox、QDateTimeEdit、QComboBox等）。

以新增教室对话框ClassroomDialog为例：

classroomdialog.cpp 中的提交按钮槽函数：

void ClassroomDialog::on_buttonBox_accepted() { QString roomNumber = ui->lineEditRoomNumber->text().trimmed(); QString building = ui->lineEditBuilding->text().trimmed(); int capacity = ui->spinBoxCapacity->value(); bool hasMultimedia = ui->checkBoxMultimedia->isChecked(); QString description = ui->textEditDescription->toPlainText().trimmed(); // 1. 数据校验 if (roomNumber.isEmpty() || building.isEmpty()) { QMessageBox::warning(this, "输入错误", "教室编号和楼栋不能为空！"); return; } // 检查教室编号是否已存在 QSqlQuery query(DatabaseConnection::getInstance().getDatabase()); query.prepare("SELECT COUNT(*) FROM classroom WHERE room_number = ?"); query.addBindValue(roomNumber); if (query.exec() && query.next() && query.value(0).toInt() > 0) { QMessageBox::warning(this, "输入错误", "教室编号已存在！"); return; } // 2. 插入数据库 query.prepare("INSERT INTO classroom (room_number, building, capacity, has_multimedia, description) " "VALUES (?, ?, ?, ?, ?)"); query.addBindValue(roomNumber); query.addBindValue(building); query.addBindValue(capacity); query.addBindValue(hasMultimedia ? 1 : 0); query.addBindValue(description); if (!query.exec()) { QMessageBox::critical(this, "数据库错误", "插入教室信息失败：\n" + query.lastError().text()); return; } // 3. 成功，关闭对话框 (accept()会触发accepted()信号) accept(); }

注意事项：

  1. SQL注入防御：永远不要用字符串拼接的方式构造SQL语句，如QString sql = "INSERT ... VALUES ('" + roomNumber + "')"。这极其危险！务必使用参数化查询（Prepared Statement），即上面代码中的?占位符和addBindValue()方法。这是编写数据库程序必须养成的安全习惯。
  2. 数据校验：前端UI的校验（如QIntValidator）和后台逻辑的校验缺一不可。后台校验是保证数据完整性的最后防线。
  3. 用户反馈：任何数据库操作（成功或失败）都应通过QMessageBox等方式给用户明确的反馈。

5. 核心业务功能实现与难点解析

有了基础的CRUD，接下来实现系统的核心业务逻辑：教室预约与冲突检测。

5.1 预约逻辑与时间冲突检测

这是整个系统的业务核心。当用户提交一个预约申请（申请人、用途、开始时间、结束时间、教室ID）时，我们必须检查该教室在所选时间段内是否已被占用。

reservationdialog.cpp 中的冲突检测函数：

bool ReservationDialog::checkTimeConflict(int classroomId, const QDateTime& startTime, const QDateTime& endTime, int excludeReservationId) { // excludeReservationId用于在“修改”预约时，排除自身这条记录 if (startTime >= endTime) { QMessageBox::warning(this, "时间错误", "结束时间必须晚于开始时间！"); return true; // 视为冲突，阻止提交 } QSqlQuery query(DatabaseConnection::getInstance().getDatabase()); QString sql = "SELECT COUNT(*) FROM reservation WHERE classroom_id = ? " "AND status != 'rejected' " // 通常被拒绝的预约不占资源 "AND ((start_time < ? AND end_time > ?) " // 新预约在已有预约中间开始 "OR (start_time < ? AND end_time > ?) " // 新预约在已有预约中间结束 "OR (start_time >= ? AND end_time <= ?))"; // 新预约完全在已有预约范围内（或反之） if (excludeReservationId != -1) { sql += " AND id != ?"; } query.prepare(sql); query.addBindValue(classroomId); query.addBindValue(endTime); query.addBindValue(startTime); query.addBindValue(endTime); query.addBindValue(startTime); query.addBindValue(startTime); query.addBindValue(endTime); if (excludeReservationId != -1) { query.addBindValue(excludeReservationId); } if (!query.exec()) { qDebug() << "Conflict check query failed:" << query.lastError().text(); return true; // 查询失败，保守起见视为冲突 } if (query.next()) { return query.value(0).toInt() > 0; // 如果找到记录数>0，说明有冲突 } return false; }

在提交预约的槽函数中调用：

void ReservationDialog::on_buttonBox_accepted() { // ... 获取对话框中的输入数据 classroomId, startTime, endTime 等 ... int reservationId = -1; // 新增时为-1，修改时传入原有ID if (checkTimeConflict(classroomId, startTime, endTime, reservationId)) { QMessageBox::warning(this, "预约冲突", "该教室在所选时间段内已被占用，请选择其他时间或教室。"); return; // 阻止提交 } // ... 通过校验，执行INSERT或UPDATE操作 ... }

难点解析：时间冲突检测的SQL条件是关键。上面代码中的条件覆盖了所有重叠情况：

  1. 新预约的开始时间在某个已有预约之内。
  2. 新预约的结束时间在某个已有预约之内。
  3. 新预约完全包含了某个已有预约（或完全被包含）。 用数学区间来表示就是：判断两个时间段[start1, end1]和[start2, end2]是否有交集，条件是start1 < end2 && start2 < end1。上面的SQL语句是这种逻辑的展开形式，并考虑了状态过滤（如rejected状态不冲突）和排除自身（修改时）的情况。

5.2 数据查询与筛选功能

主界面通常需要提供搜索功能，例如按楼栋筛选教室，或按日期范围查询预约。

在MainWindow中实现一个搜索教室的函数：

void MainWindow::on_searchButton_clicked() { QString buildingFilter = ui->comboBoxBuildingFilter->currentText(); // 楼栋筛选 QString roomKeyword = ui->lineEditRoomSearch->text().trimmed(); // 教室编号关键字 int minCapacity = ui->spinBoxMinCapacity->value(); // 最小容量 QString whereClause = "1=1"; // 永真条件，便于拼接 if (!buildingFilter.isEmpty() && buildingFilter != "全部") { whereClause += QString(" AND building = '%1'").arg(buildingFilter); // 注意：简单拼接有风险，建议用参数化 } if (!roomKeyword.isEmpty()) { whereClause += QString(" AND room_number LIKE '%%1%'").arg(roomKeyword); } whereClause += QString(" AND capacity >= %1").arg(minCapacity); QString queryStr = QString("SELECT id, room_number, building, capacity FROM classroom WHERE %1 ORDER BY building, room_number").arg(whereClause); m_classroomModel->setQuery(queryStr); // 更好的做法是使用参数化查询构建queryStr，这里为演示简洁用了拼接，实际项目务必用参数化！ }

安全提醒：上面的搜索示例为了直观，使用了字符串拼接来构建WHERE子句，这在buildingFilter或roomKeyword来自用户输入时是极其危险的，会引发SQL注入。在实际编码中，必须使用参数化查询来构建动态SQL，即使它看起来更复杂一些。可以构建一个带参数的QSqlQuery，然后根据条件动态添加AND子句和绑定对应的值。

6. 项目调试、打包与部署

功能开发完成后，让程序能稳定运行并交付给别人使用，是最后也是重要的一步。

6.1 常见问题与调试技巧

  1. 数据库连接失败：

    • 现象：程序启动时报错“QSQLITE: Unable to open database”。
    • 排查：检查数据库文件路径是否正确、是否有写权限。使用qDebug() << QDir::currentPath();输出当前工作目录。最好使用绝对路径或位于用户目录下的路径。
    • 解决：在openConnection函数中，先检查目录是否存在，不存在则创建。

  2. 中文乱码：

    • 现象：界面或数据库中的中文显示为问号或乱码。
    • 解决：
      • 源代码文件编码：确保.cpp和.h文件保存为UTF-8 with BOM（在Windows上，Qt Creator默认如此）。在Qt Creator中，可通过“编辑”->“Select Encoding”查看和转换。
      • 数据库编码：SQLite默认UTF-8，一般没问题。如果从其他来源导入数据，注意编码转换。
      • 界面显示：确保UI文件中的中文也正常。有时需要在main函数开头设置编码：QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));（QT5中方式有所变化，可查询QTextCodec或QString的相关文档）。

  3. 程序崩溃（QT崩溃）：

    • 常见原因：空指针访问、信号槽连接错误（参数类型不匹配）、在错误的线程中操作GUI。
    • 调试：在Qt Creator中以Debug模式运行，当崩溃时，查看“应用程序输出”和“调试器”面板的调用堆栈（Call Stack），能精确定位到出错的代码行。
    • 预防：对任何可能为空的指针（如通过ui->xxx获取未初始化的控件、new失败的对象）进行判空。使用Q_DECL_OVERRIDE检查虚函数重写。仔细检查信号槽连接的参数。

  4. SQL语句执行错误：

    • 永远检查QSqlQuery::lastError()。将错误信息打印到控制台或日志文件。
    • 使用QSqlQuery::prepare()和addBindValue()，避免语法错误和注入。
    • 在开发阶段，可以先将要执行的SQL字符串打印出来，放到数据库管理工具（如DB Browser for SQLite）里执行，看是否有语法错误。

6.2 项目打包发布

在Qt Creator中使用Release模式编译项目后，你会得到一个.exe文件。但这个.exe不能单独运行，它依赖一堆QT的动态链接库（DLL）。

使用windeployqt工具自动化打包：这是QT官方提供的部署工具，能自动找到你的程序所需的所有依赖库。

  1. 在开始菜单找到“Qt 5.15.2 (MSVC 2019 64-bit)”下的“Qt 5.15.2 (MSVC 2019 64-bit) Command Prompt”，打开它。
  2. 命令行切换到你的Release版.exe文件所在的目录。
  3. 执行命令：windeployqt --release --no-compiler-runtime --no-angle --no-opengl-sw YourAppName.exe
    • --release：部署Release版本。
    • --no-compiler-runtime：不包含VC++运行时库（用户可能需要单独安装）。
    • --no-angle、--no-opengl-sw：排除一些不常用的图形模块，减小体积。
  4. 执行后，该目录下会生成许多.dll文件、platforms文件夹等。此时，这个目录下的所有文件一起，就可以拷贝到其他没有安装QT的Windows电脑上运行了。

进一步精简和制作安装包：

  • 精简：检查windeployqt生成的DLL，有些可能用不到（比如Qt5SerialPort.dll如果没用到串口）。可以尝试删除一些，然后在干净的虚拟机里测试是否运行正常。
  • 安装包：使用Inno Setup或NSIS等免费安装包制作工具，将你的程序文件夹打包成一个.exe安装程序，可以添加桌面快捷方式、开始菜单项等，显得更专业。

完成以上所有步骤，一个功能完整、结构清晰、可以独立运行的“QT+SQL教室管理系统”就真正完成了。这个过程里，你实践的不只是C++语法，更是软件工程的全流程。遇到问题、解决问题的过程，才是课程设计带给你的最大财富。