C++/Qt/SQLite3课程设计选题系统开发全流程实战-尧图网络科技

1. 项目概述与核心价值

最近刚带着几个学生做完一个课程设计的选题系统，用的就是C++、Qt和SQLite3这套经典组合。这项目乍一听挺“课程设计”的，好像就是个学生作业，但实际做下来，你会发现它麻雀虽小，五脏俱全，几乎涵盖了桌面应用开发从界面到数据库、从业务逻辑到部署上线的全流程。很多新手学C++，总觉得语法复杂，不知道学了能干嘛，做个控制台小游戏又觉得不过瘾。其实用Qt搭个带界面的应用，再用SQLite3存点数据，这个组合拳打下来，你对C++面向对象、内存管理、数据结构的理解，会比单纯刷题深刻得多。

这个选题系统要解决的核心问题很明确：就是让老师和学生在课程设计这个环节里，能高效、公平、有条理地完成双向选择。老师可以发布课题，设定名额和要求；学生可以浏览课题，提交申请；系统需要自动处理冲突，比如一个学生不能选多个课题，一个课题招满后自动关闭。最终，管理员（通常是教学秘书或负责老师）能看到全局的统计报表。听起来简单，但里面涉及的用户角色权限管理、数据库表设计、前后端数据同步、以及如何用C++优雅地处理这些业务逻辑，都是实打实的练手机会。

我选择C++/Qt/SQLite3这个技术栈，是基于几个很实际的考虑。首先，C++的执行效率没得说，处理几百上千条学生选题数据，响应速度是瞬间的，这对于需要即时反馈的桌面应用很重要。其次，Qt框架的成熟度非常高，信号槽机制用来处理UI事件和业务逻辑的解耦非常舒服，自带的UI设计器也能快速搭建出专业的界面，省去了从零画控件的麻烦。最后，SQLite3作为一个轻量级、无服务器的数据库，直接一个.db文件搞定所有数据存储，部署和迁移成本极低，特别适合这种单机或小范围局域网使用的桌面应用。你不用折腾MySQL或PostgreSQL的安装配置，学生拿到源码和数据库文件就能直接跑起来，极大地降低了学习和复现的门槛。

2. 技术栈选型与项目架构设计

2.1 为什么是C++、Qt与SQLite3的组合？

很多同学在开始这类项目时，可能会纠结于技术选型。为什么不用Python的PyQt或Tkinter？或者用Java Swing？甚至用更现代的Electron？这里我结合这次项目的实际体验，聊聊选型背后的逻辑。

C++的核心优势在于性能与控制力。课程设计选题系统虽然数据量不大，但涉及频繁的数据库查询（如学生浏览所有课题）、条件过滤（如按专业筛选课题）、以及可能的数据统计（如各课题报名人数）。C++原生编译执行的效率，确保了所有操作都能在用户无感知的延迟内完成。更重要的是，通过这个项目，你能深入实践C++的面向对象编程（OOP）。你需要设计Student、Teacher、Project、Application等类，并处理好它们之间的关联。这比写一个简单的struct要复杂，但正是这种复杂性，逼着你去思考类的职责单一、数据封装、以及如何通过继承和多态来优雅地扩展功能（比如，User作为基类，Student和Teacher继承它）。

Qt框架是C++桌面开发的“加速器”。纯用C++和Win32 API或MFC去画界面，那绝对是噩梦。Qt把这一切都封装好了。它的信号与槽（Signals & Slots）机制是核心，你可以理解为一种松耦合的事件通信方式。比如，界面上一个“提交申请”按钮被点击（发出clicked()信号），这个信号可以连接到某个处理函数（槽函数）去执行插入数据库的操作。这种机制让UI逻辑和业务逻辑清晰分离。另外，Qt Creator IDE自带的UI设计器（Qt Designer）是可视化拖拽控件，能自动生成对应的.ui文件（本质是XML），再通过uic工具编译成C++头文件，开发效率极高。对于课程设计这种需要快速出原型、且界面不能太丑的项目，Qt几乎是唯一选择。

SQLite3：轻量级数据存储的绝佳选择。它的最大特点就是“零配置”。不需要安装数据库服务器，它的数据库就是一个普通的磁盘文件（比如project_selection.db）。我们的应用程序通过SQLite3的C/C++接口库，直接读写这个文件。这对于课程设计项目的分发和演示极其友好。你只需要把可执行程序（exe）和这个.db文件打包，在任何Windows电脑上都能运行。SQLite3支持标准的SQL语法，事务、索引、触发器这些高级特性也都有，完全能满足我们系统的所有数据持久化需求。在代码中，我们通常会用一些简单的封装类来管理数据库连接和执行SQL，避免到处写重复的、容易出错的SQL字符串拼接代码。

2.2 系统整体架构与模块划分

基于上述技术栈，我设计了一个典型的三层架构，虽然是在一个桌面应用内实现，但思想是相通的。

1. 数据访问层：这是最底层，职责是封装所有对SQLite3数据库的操作。我设计了一个DatabaseManager单例类。为什么用单例？因为在整个应用生命周期内，我们只需要一个全局的数据库连接，单例模式可以方便地在任何地方获取到这个连接实例，同时避免重复打开连接造成的资源浪费和潜在冲突。DatabaseManager类主要提供以下方法：

bool openDatabase(const QString &path): 打开或创建数据库文件。
bool initializeTables(): 在数据库首次创建时，执行建表SQL语句，创建users（用户表）、projects（课题表）、applications（选课申请表）等。
QSqlQuery executeQuery(const QString &sql, const QVariantList &args = QVariantList()): 执行带参数的SQL查询，使用QVariantList绑定参数可以有效防止SQL注入攻击。
以及一些针对特定业务的封装方法，如getAllProjects()、addStudentApplication(int studentId, int projectId)等，这样上层业务逻辑代码读起来会更清晰。

2. 业务逻辑层：这一层是系统的“大脑”，包含了核心的业务规则和数据处理。它不关心数据怎么存（那是数据层的事），也不关心界面怎么显示（那是表现层的事）。我主要设计了几个核心的模型类（Model）：

UserModel: 对应users表，包含id,username,password（存储哈希值，切勿存明文！）,role（student/teacher/admin）,name,major等字段。负责用户的登录验证和基本信息管理。
ProjectModel: 对应projects表，包含id,title,description,teacher_id,capacity（容量）,selected_count（已选人数）,status（open/closed）等。负责课题的增删改查，以及判断是否已满额。
ApplicationModel: 对应applications表，包含id,student_id,project_id,apply_time,status（pending/approved/rejected）等。负责处理选课申请的逻辑，比如一个学生能否申请某个课题（检查是否重复申请、课题是否开放、是否已满）。

这一层会大量调用数据访问层提供的接口，并实现诸如“学生申请课题”、“老师审批申请”、“系统自动根据规则进行初筛”等核心业务函数。

3. 用户界面层：这是用户直接交互的部分，用Qt的Widgets模块实现。根据用户角色，我设计了不同的主界面：

学生界面：主要包括课题列表浏览（用QTableWidget或QListView展示）、搜索过滤框、课题详情查看、以及“申请”按钮。学生还能查看自己已提交的申请状态。
教师界面：除了发布新课题的表单，最重要的是一个管理面板，可以看到自己发布的所有课题及其申请学生列表，并能进行“通过”或“拒绝”操作。
管理员界面：拥有最高权限，可以管理所有用户和课题，查看系统全局统计报表（例如，使用Qt Charts模块生成各课题报名人数的柱状图）。

界面层通过Qt的信号槽机制，与业务逻辑层进行通信。例如，学生界面点击“申请”按钮，会触发一个信号，这个信号连接到业务逻辑层的一个槽函数，该函数调用ApplicationModel的相关方法，并最终通过DatabaseManager将数据写入数据库。操作成功后，业务逻辑层再发射一个信号通知界面层更新显示（比如刷新课题的已报名人数）。

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

3.1 SQLite3数据库表结构详解

数据库设计是整个系统的基石，设计得好，后面编程逻辑就清晰；设计得不好，会写很多冗余和复杂的代码。我设计了四张核心表：

users 表：

CREATE TABLE users ( id INTEGER PRIMARY KEY AUTOINCREMENT, username TEXT UNIQUE NOT NULL, -- 登录账号，唯一 password_hash TEXT NOT NULL, -- 密码的哈希值，例如bcrypt或SHA256 role TEXT NOT NULL CHECK(role IN ('student', 'teacher', 'admin')), real_name TEXT NOT NULL, major TEXT, -- 学生专业/教师院系 created_at DATETIME DEFAULT CURRENT_TIMESTAMP );

注意：密码绝对不能用明文存储。我使用的是QCryptographicHash类对密码和随机盐值（salt）进行多次哈希（如SHA-256），然后将盐值和哈希值一起存入password_hash字段。验证时，用同样的盐值对用户输入的密码进行哈希，再与存储的哈希值比对。

projects 表：

CREATE TABLE projects ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, -- 课题标题 description TEXT, -- 详细描述 teacher_id INTEGER NOT NULL, -- 发布教师ID，外键关联users.id capacity INTEGER NOT NULL DEFAULT 1, -- 最大可选人数 selected_count INTEGER NOT NULL DEFAULT 0, -- 当前已选人数 status TEXT DEFAULT 'open' CHECK(status IN ('open', 'closed')), -- 开放/关闭 requirements TEXT, -- 可选，对学生的基础要求 created_at DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (teacher_id) REFERENCES users(id) ON DELETE CASCADE );

这里有一个关键点：selected_count字段。每次有申请被approved（通过），这个数字就+1，并与capacity比较。当selected_count >= capacity时，自动将status更新为'closed'。这个逻辑可以用数据库触发器（Trigger）实现，但为了简单和可控，我选择在业务代码中实现。

applications 表（核心中的核心）：

CREATE TABLE applications ( id INTEGER PRIMARY KEY AUTOINCREMENT, student_id INTEGER NOT NULL, project_id INTEGER NOT NULL, apply_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TEXT DEFAULT 'pending' CHECK(status IN ('pending', 'approved', 'rejected')), -- 唯一约束，防止同一学生对同一课题重复申请（尽管业务层也会检查） UNIQUE(student_id, project_id), FOREIGN KEY (student_id) REFERENCES users(id) ON DELETE CASCADE, FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE );

UNIQUE(student_id, project_id)这个约束非常重要，它是数据库层面保证数据一致性的最后防线。即使我们业务逻辑的检查有漏洞，数据库也会阻止重复数据的插入。

（可选）system_log 表：用于记录关键操作，便于追踪和审计。

CREATE TABLE system_log ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER, action TEXT NOT NULL, -- 如 'login', 'apply_project', 'approve_application' details TEXT, ip_address TEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP );

3.2 核心业务逻辑的C++实现要点

有了清晰的数据结构，业务逻辑的实现就是“按图索骥”。我挑几个关键函数讲讲实现细节和踩过的坑。

1. 用户登录验证：

bool UserModel::authenticate(const QString &username, const QString &password) { QSqlQuery query; query.prepare("SELECT id, password_hash, role FROM users WHERE username = ?"); query.addBindValue(username); if (!query.exec() || !query.next()) { return false; // 用户不存在或查询失败 } int userId = query.value(0).toInt(); QString storedHash = query.value(1).toString(); QString role = query.value(2).toString(); // 假设我们存储的hash是 “盐值:哈希值” 的格式 QStringList parts = storedHash.split(":"); if (parts.size() != 2) return false; QString salt = parts[0]; QString expectedHash = parts[1]; // 使用相同的盐值对输入密码进行哈希 QString inputHash = hashPassword(password, salt); if (inputHash == expectedHash) { // 登录成功，将当前用户信息存储到全局或单例中，供其他模块使用 CurrentUser::instance()->setId(userId); CurrentUser::instance()->setRole(role); // 记录日志 logAction(userId, "login", QString("User %1 logged in").arg(username)); return true; } return false; }

实操心得：密码验证一定要在服务器端（对我们来说就是业务逻辑层）进行。即使前端（Qt界面）做了输入校验，后端也必须重新校验。QSqlQuery::prepare()和addBindValue()是防止SQL注入的黄金法则，永远不要用字符串拼接的方式构造SQL语句。

2. 学生申请课题：这是最复杂的业务之一，需要在一个事务（Transaction）内完成多个检查和操作，以保证数据一致性。

bool ApplicationModel::applyForProject(int studentId, int projectId) { QSqlDatabase db = QSqlDatabase::database(); // 获取默认数据库连接 db.transaction(); // 开始事务 try { // 检查1：课题是否存在且状态为open QSqlQuery checkProject; checkProject.prepare("SELECT capacity, selected_count, status FROM projects WHERE id = ? FOR UPDATE"); // 注意：SQLite3默认不支持FOR UPDATE，但这里表达了“锁定”的意图。实际SQLite中，事务内的写操作会锁定相关行。 checkProject.addBindValue(projectId); if (!checkProject.exec() || !checkProject.next()) { throw std::runtime_error("课题不存在"); } int capacity = checkProject.value(0).toInt(); int selected = checkProject.value(1).toInt(); QString status = checkProject.value(2).toString(); if (status != "open" || selected >= capacity) { throw std::runtime_error("课题已满或关闭"); } // 检查2：该学生是否已经申请过此课题（业务层检查，数据库UNIQUE约束是兜底） QSqlQuery checkDup; checkDup.prepare("SELECT COUNT(*) FROM applications WHERE student_id = ? AND project_id = ?"); checkDup.addBindValue(studentId); checkDup.addBindValue(projectId); checkDup.exec(); checkDup.next(); if (checkDup.value(0).toInt() > 0) { throw std::runtime_error("不能重复申请同一课题"); } // 检查3：（可选）学生是否已经有一个被批准的申请？根据规则，可能一人只能成功选一个。 QSqlQuery checkApproved; checkApproved.prepare("SELECT COUNT(*) FROM applications WHERE student_id = ? AND status = 'approved'"); checkApproved.addBindValue(studentId); checkApproved.exec(); checkApproved.next(); if (checkApproved.value(0).toInt() > 0) { throw std::runtime_error("您已有一个被批准的课题，无法再申请"); } // 执行插入申请 QSqlQuery insertApp; insertApp.prepare("INSERT INTO applications (student_id, project_id, status) VALUES (?, ?, 'pending')"); insertApp.addBindValue(studentId); insertApp.addBindValue(projectId); if (!insertApp.exec()) { throw std::runtime_error("申请提交失败: " + insertApp.lastError().text().toStdString()); } // 注意：这里我们并没有立即更新projects表的selected_count。 // 因为申请状态是'pending'，只有被老师批准后，selected_count才+1。 // 如果规则是“申请即占用名额”，则此处需要更新selected_count并判断是否满额。 db.commit(); // 提交事务 logAction(studentId, "apply_project", QString("Applied for project %1").arg(projectId)); return true; } catch (const std::exception &e) { db.rollback(); // 回滚事务，所有操作撤销 qDebug() << "申请失败:" << e.what(); return false; } }

踩坑记录：事务的使用至关重要。想象一下，检查通过后，在插入申请记录时失败了，如果没有事务，系统就会处于一个不一致的状态（比如，检查了课题未满，但申请没记录上）。事务保证了这些操作要么全部成功，要么全部失败。SQLite3中，除了BEGIN TRANSACTION和COMMIT/ROLLBACK，还要注意写操作会锁定整个数据库文件，所以在高并发场景（虽然我们这系统一般没有）下，要尽量缩短事务持有时间。

3. 教师审批申请：教师操作时，需要更新申请状态，并可能触发课题名额的更新。

bool ApplicationModel::processApplication(int applicationId, const QString &newStatus, int teacherId) { // newStatus 应为 'approved' 或 'rejected' QSqlDatabase db = QSqlDatabase::database(); db.transaction(); try { // 首先，验证该申请对应的课题是否是当前教师发布的 QSqlQuery validateQuery; validateQuery.prepare("SELECT p.id, p.selected_count, p.capacity FROM applications a " "JOIN projects p ON a.project_id = p.id " "WHERE a.id = ? AND p.teacher_id = ?"); validateQuery.addBindValue(applicationId); validateQuery.addBindValue(teacherId); if (!validateQuery.exec() || !validateQuery.next()) { throw std::runtime_error("无权操作此申请或申请不存在"); } int projectId = validateQuery.value(0).toInt(); int selectedCount = validateQuery.value(1).toInt(); int capacity = validateQuery.value(2).toInt(); // 获取申请当前状态和学生ID QSqlQuery appQuery; appQuery.prepare("SELECT student_id, status FROM applications WHERE id = ?"); appQuery.addBindValue(applicationId); appQuery.exec(); appQuery.next(); int studentId = appQuery.value(0).toInt(); QString oldStatus = appQuery.value(1).toString(); // 更新申请状态 QSqlQuery updateApp; updateApp.prepare("UPDATE applications SET status = ? WHERE id = ?"); updateApp.addBindValue(newStatus); updateApp.addBindValue(applicationId); if (!updateApp.exec()) { throw std::runtime_error("更新申请状态失败"); } // 如果是从其他状态变为 approved，需要增加课题的已选人数 if (newStatus == "approved" && oldStatus != "approved") { if (selectedCount >= capacity) { // 理论上，由于事务和之前的检查，这里不应该发生。但作为安全兜底。 throw std::runtime_error("课题名额已满，无法批准"); } QSqlQuery updateProject; updateProject.prepare("UPDATE projects SET selected_count = selected_count + 1 WHERE id = ?"); updateProject.addBindValue(projectId); if (!updateProject.exec()) { throw std::runtime_error("更新课题人数失败"); } selectedCount++; // 检查并更新课题状态 if (selectedCount >= capacity) { QSqlQuery closeProject; closeProject.prepare("UPDATE projects SET status = 'closed' WHERE id = ?"); closeProject.addBindValue(projectId); closeProject.exec(); } } // 如果是从 approved 变为其他状态（如rejected），需要减少课题的已选人数 else if (newStatus != "approved" && oldStatus == "approved") { QSqlQuery updateProject; updateProject.prepare("UPDATE projects SET selected_count = selected_count - 1 WHERE id = ?"); updateProject.addBindValue(projectId); updateProject.exec(); // 即使人数减到0以下，业务上也是允许的（恢复名额） // 如果课题之前是closed状态，现在人数减少了，可能需要重新开放？根据业务规则决定。 // 例如：if (selectedCount - 1 < capacity) { set status='open'; } } db.commit(); QString action = newStatus == "approved" ? "approve_application" : "reject_application"; logAction(teacherId, action, QString("Processed application %1 for student %2").arg(applicationId).arg(studentId)); return true; } catch (const std::runtime_error &e) { db.rollback(); qDebug() << "审批处理失败:" << e.what(); return false; } }

这个函数逻辑比较复杂，但体现了业务规则的核心：状态变更伴随着关联数据的联动更新。务必在事务内完成，确保“申请状态”和“课题人数”始终同步。

4. Qt界面设计与数据交互实战

4.1 使用Qt Designer快速构建用户界面

Qt Creator的UI设计器大大提升了开发效率。以学生主界面为例，我通常会这样布局：

顶部工具栏：放置用户信息显示（如“欢迎，张三同学”）、退出登录按钮。
左侧筛选区：一个QGroupBox，里面放几个QComboBox（按专业筛选、按状态筛选）和一个QLineEdit（关键词搜索），以及一个“搜索”按钮。
中部课题列表区：一个QTableWidget。设置好列标题：ID、课题名称、指导教师、名额（已选/总量）、状态、操作。
- 关键技巧：将“操作”列（比如放一个“申请”按钮）设置为自定义的QWidget。我们需要在代码中为每一行动态创建这个按钮，并连接其点击信号。
右侧详情面板：一个QTextEdit或几个QLabel，用于显示在列表中选择的某一课题的详细描述和要求。

设计好.ui文件后，Qt Creator会自动生成对应的ui_xxxx.h文件。在我们的主窗口类（如StudentMainWindow）中，通过ui->tableWidget等方式就可以访问这些界面元素。

4.2 使用Model/View框架优雅显示数据

虽然QTableWidget用起来直接，但在数据量稍大或需要频繁更新时，更推荐使用Qt的Model/View架构。这里我使用QSqlTableModel或QSqlQueryModel来连接数据库和视图。

示例：加载课题列表到TableView

// 在StudentMainWindow的初始化函数中 void StudentMainWindow::initProjectTableView() { // 创建模型 QSqlQueryModel *model = new QSqlQueryModel(this); // 构建查询语句，可以动态加入筛选条件 QString sql = "SELECT p.id, p.title, u.real_name as teacher_name, " "p.selected_count, p.capacity, p.status " "FROM projects p " "JOIN users u ON p.teacher_id = u.id " "WHERE p.status = 'open'"; // 初始只显示开放的课题 // 如果用户选择了专业筛选 if (!m_currentMajorFilter.isEmpty()) { sql += " AND u.major = :major"; // 注意：这里假设老师也有major字段，或者课题有专业属性。实际情况可能不同。 } sql += " ORDER BY p.created_at DESC"; model->setQuery(sql); // 处理查询错误 if (model->lastError().isValid()) { qDebug() << "Query error:" << model->lastError().text(); return; } // 设置表头 model->setHeaderData(0, Qt::Horizontal, tr("ID")); model->setHeaderData(1, Qt::Horizontal, tr("课题名称")); model->setHeaderData(2, Qt::Horizontal, tr("指导教师")); model->setHeaderData(3, Qt::Horizontal, tr("已选/名额")); model->setHeaderData(4, Qt::Horizontal, tr("状态")); // 将模型设置给视图 ui->tableView->setModel(model); // 隐藏ID列（通常不需要给用户看） ui->tableView->hideColumn(0); // 为每一行添加操作按钮（自定义委托是更好的方式，这里为简单使用按钮） // 更优雅的做法是使用QStyledItemDelegate来自定义“操作”列的渲染和编辑。 // 由于涉及较多代码，此处简述思路：可以添加一个“操作”列，在该列的paint事件中绘制按钮，或使用QTableView的setIndexWidget为特定索引设置一个真实的QPushButton。 }

使用Model/View的好处是，当底层数据库数据变化时（比如别的同学申请了某个课题导致人数变化），我们只需要重新执行模型的setQuery()，视图会自动更新，无需手动去修改QTableWidget的每一项。

4.3 信号槽连接与界面刷新

界面交互的核心是信号槽。例如，处理列表视图中“申请”按钮的点击：

// 假设我们通过某种方式（如自定义委托）为每一行的“操作”列设置了一个按钮，并存储了课题ID到按钮的property中。 void StudentMainWindow::onApplyButtonClicked() { QPushButton *button = qobject_cast<QPushButton*>(sender()); if (!button) return; int projectId = button->property("projectId").toInt(); QString projectTitle = button->property("projectTitle").toString(); // 弹出确认对话框 QMessageBox::StandardButton reply; reply = QMessageBox::question(this, "确认申请", QString("确定要申请课题《%1》吗？").arg(projectTitle), QMessageBox::Yes | QMessageBox::No); if (reply == QMessageBox::Yes) { int currentStudentId = CurrentUser::instance()->id(); // 调用业务逻辑层的申请函数 bool success = ApplicationModel::instance()->applyForProject(currentStudentId, projectId); if (success) { QMessageBox::information(this, "成功", "申请提交成功，请等待教师审核。"); // 申请成功后，刷新课题列表和已申请列表 refreshProjectList(); refreshMyApplications(); } else { QMessageBox::warning(this, "失败", "申请提交失败，可能原因：课题已满、您已申请过或系统错误。"); } } }

refreshProjectList()和refreshMyApplications()函数内部会重新从数据库加载数据并更新对应的视图（如QTableView或QListWidget）。这就是一个完整的“用户操作 -> 业务处理 -> 界面反馈”的闭环。

5. 项目构建、部署与常见问题排查

5.1 使用CMake构建Qt项目

现代Qt项目推荐使用CMake进行构建管理，比传统的.pro文件更灵活，特别是与像SQLite3这样的第三方库集成时。一个基本的CMakeLists.txt骨架如下：

cmake_minimum_required(VERSION 3.16) project(CourseDesignSelectionSystem VERSION 1.0.0 LANGUAGES CXX) # 设置C++标准 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 自动查找所需的Qt组件 find_package(Qt6 REQUIRED COMPONENTS Core Widgets Sql) # 如果使用Qt5，则用 find_package(Qt5 REQUIRED COMPONENTS Core Widgets Sql) # 启用Qt的MOC、UIC、RCC自动处理 set(CMAKE_AUTOMOC ON) set(CMAKE_AUTUIC ON) set(CMAKE_AUTORCC ON) # 添加可执行文件目标 add_executable(SelectionSystem src/main.cpp src/mainwindow.cpp src/databasemanager.cpp src/usermodel.cpp src/projectmodel.cpp src/applicationmodel.cpp # ... 其他源文件 ) # 添加头文件目录 target_include_directories(SelectionSystem PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include ) # 链接Qt库 target_link_libraries(SelectionSystem PRIVATE Qt6::Core Qt6::Widgets Qt6::Sql # 如果需要Charts，再加 Qt6::Charts ) # 链接SQLite3库。在Windows上，SQLite3通常需要自己编译或下载预编译库。 # 假设你将sqlite3.c和sqlite3.h放在 third_party/sqlite3/ 下 add_library(sqlite3 STATIC third_party/sqlite3/sqlite3.c) target_include_directories(SelectionSystem PRIVATE third_party/sqlite3) target_link_libraries(SelectionSystem PRIVATE sqlite3) # 在macOS/Linux上，也可以使用系统包管理器安装的sqlite3 # find_package(SQLite3 REQUIRED) # target_link_libraries(SelectionSystem PRIVATE SQLite::SQLite3) # 处理Qt的.ui和.qrc文件 qt_add_resources(SelectionSystem "app_resources" PREFIX "/" FILES resources/icons.qrc )

使用CMake后，你可以用命令行（在build目录中执行cmake ..和cmake --build .）或者用支持CMake的IDE（如CLion、VS Code with CMake Tools、Qt Creator本身）来构建项目，非常方便。

5.2 打包与部署（以Windows为例）

开发完成后，我们需要将程序分发给最终用户（老师和学生）。Qt程序不能直接复制.exe文件，因为它依赖一系列的Qt动态链接库（DLL）。

使用windeployqt工具（最推荐）：这是Qt官方提供的部署工具。首先在Release模式下编译你的项目，生成SelectionSystem.exe。然后打开Qt自带的命令行（如“Qt 6.5.0 MSVC2019 64-bit”），导航到你的exe所在目录，执行：
```
windeployqt SelectionSystem.exe
```
这个命令会自动扫描你的exe文件，找出所有需要的Qt库（Core, Gui, Widgets, Sql等）的DLL，以及必要的插件（如图像格式插件qjpeg.dll、SQL驱动插件qsqlite.dll），并复制到exe的同级目录下。
手动补充SQLite3驱动：windeployqt有时可能不会自动包含qsqlite.dll（尽管我们用了Qt Sql模块）。你需要手动从Qt的安装目录（例如Qt\6.5.0\msvc2019_64\plugins\sqldrivers）找到qsqlite.dll，并将其复制到部署文件夹下的sqldrivers子目录中（如果没有就创建一个）。同时，确保你的应用程序在运行时能正确找到这个插件目录。一种简单的方法是在main.cpp开头添加：
```
#include <QApplication> #include <QDir> int main(int argc, char *argv[]) { QApplication a(argc, argv); // 设置插件路径，让程序能找到本地的sqlite驱动 QDir dir(QCoreApplication::applicationDirPath()); dir.cd("sqldrivers"); // 进入sqldrivers子目录 QCoreApplication::addLibraryPath(dir.absolutePath()); // ... 其余代码 }
```
包含数据库文件：将你的project_selection.db数据库文件也复制到exe同级目录。在代码中，打开数据库时使用相对路径./project_selection.db或通过QApplication::applicationDirPath()构造绝对路径。
测试：将整个文件夹（包含exe、所有DLL、plugins文件夹、数据库文件）复制到一台没有安装Qt和开发环境的Windows电脑上，运行exe，看是否能正常启动和操作。

5.3 常见问题与调试技巧实录

在开发和部署过程中，我遇到了不少典型问题，这里列出来供大家参考：

1. 数据库连接失败，错误信息包含“driver not loaded”

问题：程序启动时，QSqlDatabase::addDatabase("QSQLITE")失败，提示SQLite驱动未加载。
原因：Qt的SQL驱动是以插件形式存在的。在开发环境，Qt能自动找到；但部署时，需要手动将qsqlite.dll（或其他数据库驱动）放到正确位置。
解决：如上文部署部分所述，确保qsqlite.dll存在于可执行文件目录下的sqldrivers子文件夹中，并在main.cpp中通过QCoreApplication::addLibraryPath()添加插件路径。

2. 中文显示乱码

问题：从数据库读取的中文，或者在UI中设置的中文，显示为乱码。
原因：数据库编码、Qt字符串内部编码、文件保存编码不一致。
解决：
- 数据库：确保SQLite3数据库创建时使用UTF-8编码（默认就是）。
- 代码文件：确保你的.cpp和.h源文件保存为UTF-8 with BOM格式（在Windows上，VS或Qt Creator通常默认如此）。
- Qt字符串：在main函数中，设置默认编码为UTF-8（Qt5及之前常用，Qt6默认就是UTF-8）：
```
#include <QTextCodec> int main(...) { QApplication a(...); // Qt5: // QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8")); // Qt6 默认UTF-8，通常不需要设置 ... }
```
- UI文件：在Qt Designer中编辑.ui文件时，里面的中文字符会自动被处理，一般没问题。

3. 程序在发布版（Release）崩溃，调试版（Debug）正常

问题：这是最令人头疼的问题之一。
排查思路：
1. 检查未初始化的变量：Release版的优化更激进，未初始化变量的值是不确定的，可能导致逻辑错误或崩溃。确保所有指针在使用前都被初始化（如设为nullptr），基本类型变量赋予初值。
2. 检查数组/容器越界：使用QVector、QList或普通数组时，确保索引在有效范围内。Release版下越界访问可能不会立即崩溃，但会破坏内存，导致后续不可预知的行为。
3. 使用Qt的日志输出：在关键函数入口和可能出错的地方，使用qDebug() << “Function X called with param:” << param;。在Release版中，可以通过定义宏将qDebug重定向到文件，帮助定位问题。
4. 启用Minidump或使用调试器附加：在Windows上，可以设置异常处理函数生成minidump文件，然后用Debugger（如Visual Studio）加载分析。或者在Release构建时也生成PDB符号文件，当程序在用户电脑崩溃时，可以收集dump文件并用PDB进行符号化分析。

4. 多窗口或对话框关闭后，程序内存持续增长（疑似内存泄漏）

问题：反复打开/关闭子窗口，任务管理器显示内存占用不断增加。
原因：Qt的对象树（Parent-Child）机制能自动管理内存，子对象在父对象销毁时会被自动删除。但如果你手动new了一个对象（比如一个对话框），没有指定父对象，也没有在适当的时候delete，就会导致内存泄漏。
解决：
- 优先使用栈对象：对于生命周期和当前函数一致的对话框，可以直接在栈上创建：MyDialog dlg; dlg.exec();。
- 使用智能指针：对于需要动态创建且生命周期不确定的对象，使用QScopedPointer或std::unique_ptr。
- 正确设置父对象：如果new了一个窗口部件，并且它的生命周期应该隶属于另一个窗口，那么在创建时指定父对象：MyWidget *widget = new MyWidget(parentWidget);。这样当父部件销毁时，子部件会自动被清理。
- 使用Qt的删除机制：对于没有父对象的对象，可以调用obj->deleteLater()，让Qt在下次事件循环时安全地删除它。

5. 界面卡顿，特别是数据量大时刷新列表慢

问题：当课题或申请记录很多时，刷新QTableWidget或QListView感觉有明显的延迟。
优化方案：
- 改用Model/View：如前所述，QSqlQueryModel配合QTableView的性能通常优于QTableWidget，尤其是数据量大时，因为后者每个单元格都是一个独立的小部件。
- 分页加载：对于海量数据，不要一次性全部加载。在SQL查询中使用LIMIT和OFFSET实现分页，界面提供“上一页/下一页”按钮。
- 启用视图优化：在填充大量数据前，可以暂时禁用视图的更新。
```
ui->tableView->setUpdatesEnabled(false); // ... 执行耗时的数据加载或模型重置操作 ui->tableView->setUpdatesEnabled(true); // 或者使用模型的重置信号，视图会自动处理
```
- 异步加载：对于非常耗时的操作（比如复杂的统计查询），可以考虑使用QtConcurrent在后台线程中执行，完成后再将结果传回主线程更新UI，避免界面冻结。