简介这是一份基于Qt框架开发的个人日程管理桌面应用完整源码工程面向C与Qt初学者及GUI开发实践者解决日常事务记录、日程提醒、待办事项分类管理等实际需求。资源包含89个文件涵盖15个核心cpp实现文件、15个h头文件、6个ui界面设计文件、1个pro项目配置文件、1个sln解决方案文件以及编译生成的exe可执行程序和SQLite数据文件如date.dat、task.dat等完整呈现从UI构建、模型视图架构、数据库持久化到定时提醒的全链路实现逻辑。压缩包大小为10.83MB结构清晰含debug/release目录、moc元对象文件及多模块UI登录、注册、任务添加、日历视图等便于分层学习与调试。已有468人学习下载读者可直接编译运行深入理解Qt Widgets布局、QTimer事件提醒、QSqlDatabase本地存储、信号槽交互机制及跨平台部署要点是掌握Qt实战开发的优质入门级项目范例。1. 为什么一个“Qt 个人日程安排处理事务”的小工具反而成了我接私活时复用率最高的底层模块不是因为界面多炫——它连渐变色按钮都懒得加也不是因为功能多全——不支持协同编辑、不连云端、甚至不自动同步系统日历。真正让它在多个项目里反复被拎出来改一改就交付的是它把「事务性日程」这个模糊概念用 Qt 的信号槽 QSqlDatabase QStandardItemModel 三件套扎扎实实钉进了可持久化、可回溯、可条件过滤的本地数据流里。比如某高校教务系统对接的排课辅助模块核心就是复用了这个日程事务的「任务状态机」待处理→审核中→已归档→已驳回每个状态切换都触发对应 SQL 更新 视图刷新 日志写入。再比如某公司内部审批流 Demo直接把“事务”字段映射成「报销单号/合同编号/工单ID」日期范围改成「申请时间-审批截止时间」其余逻辑几乎零改动。它解决的从来不是“怎么显示日历”而是“如何让每一条带时间戳、带状态、带上下文的事务在离线环境下依然能被可靠地创建、查询、修改、归档”。适合正在做内部工具、审批系统、教学管理、实验记录等需要强事务语义但又不想上重服务的开发者——你不需要懂 Qt Quick只要会写 C/Python 绑定就能把它嵌进任何已有 Qt 桌面项目里。2. 用 Qt Widgets 搭建最小可行日程事务框架从数据库 Schema 到主窗口骨架2.1 设计符合事务语义的 SQLite 表结构为什么不用 QDateEdit 直接存字符串很多新手第一反应是用 QDateEdit 选个日期toString(yyyy-MM-dd) 存进 TEXT 字段完事。但“事务”不是“纪念日”——它有起止时间可能跨天、有优先级数字比文字好排序、有状态流转不能靠字符串模糊匹配、还可能关联附件路径需独立字段防污染主表。我们采用四字段核心设计CREATE TABLE IF NOT EXISTS schedule_tasks ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, description TEXT, start_time DATETIME NOT NULL, -- 精确到秒支持跨日任务 end_time DATETIME, -- 允许为空表示无明确截止 status INTEGER DEFAULT 0, -- 0:待处理 1:进行中 2:已归档 3:已驳回 priority INTEGER DEFAULT 5, -- 1~10数值越大越紧急 created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP );提示DATETIME类型在 SQLite 中本质是文本存储但 Qt 的QSqlQuery::bindValue()对QDateTime自动适配 ISO8601 格式如2024-06-15T09:30:00无需手动格式化。若用TEXT存字符串后续ORDER BY start_time会因格式不统一2024/6/15 vs 2024-06-15导致排序错乱——这是血泪经验。2.2 构建可响应状态变更的 Model-View 链路QSqlTableModel 不够用必须手撸 QStandardItemModelQt 官方文档常推QSqlTableModel但它对“状态字段”这种非纯数据列支持极弱无法在视图中直接点击下拉框切换状态也无法在提交前校验“已归档的任务不可再修改时间”。我们改用分层架构底层QSqlDatabase管理连接所有 CRUD 封装在TaskRepository类中含事务回滚逻辑中间层TaskModel : public QStandardItemModel重写setData()响应状态变更并在data()中为status列返回Qt::CheckStateRole或自定义图标视图层QTableView 自定义StatusDelegate : public QStyledItemDelegate在编辑时弹出QComboBox供选择状态。关键代码片段C// TaskModel.cpp bool TaskModel::setData(const QModelIndex index, const QVariant value, int role) { if (!index.isValid() || role ! Qt::EditRole) return false; int row index.row(); int col index.column(); QSqlRecord record m_query.record(); // 从预编译查询获取字段名 if (col STATUS_COLUMN) { // 状态变更前校验业务规则已归档任务禁止修改时间 int oldStatus record.value(status).toInt(); int newStatus value.toInt(); if (oldStatus STATUS_ARCHIVED newStatus ! STATUS_ARCHIVED) { qWarning() 拒绝操作已归档任务不可降级状态; return false; } } // 实际更新数据库 bool ok m_repo-updateTask( record.value(id).toInt(), record.fieldName(col), value ); if (ok) emit dataChanged(index, index); return ok; }逻辑说明setData()是 Model 接收用户编辑的入口。此处拦截STATUS_COLUMN列的修改调用TaskRepository::updateTask()执行 SQL UPDATE并在成功后触发dataChanged通知视图刷新。参数record.fieldName(col)确保传给仓库的是真实字段名如status而非硬编码字符串避免后期改表名时漏改。3. 实现事务核心状态机从“待处理”到“已归档”的完整流转与约束3.1 状态码定义与 UI 映射用枚举QMap 实现可维护的状态配置硬编码数字 0/1/2/3 在团队协作中极易出错。我们定义清晰枚举并绑定 UI// task_status.h enum class TaskStatus { Pending 0, // 待处理刚创建未分配执行人 InProgress 1, // 进行中已指派正在处理 Archived 2, // 已归档完成闭环不可逆 Rejected 3 // 已驳回流程终止可重新提交 }; // 在主窗口初始化时构建状态映射 QMapTaskStatus, QString statusText { {TaskStatus::Pending, 待处理}, {TaskStatus::InProgress, 进行中}, {TaskStatus::Archived, 已归档}, {TaskStatus::Rejected, 已驳回} };StatusDelegate的paint()方法根据data(Qt::DisplayRole)返回的TaskStatus值查表渲染对应中文和背景色如Pending用浅黄Archived用浅绿确保视觉反馈与业务语义严格一致。3.2 状态流转图与强制约束哪些跳转允许哪些必须走审批事务不是状态随意切换的玩具。我们按实际业务抽象出合法跳转当前状态允许跳转至触发条件数据库操作PendingInProgress用户点击“开始处理”UPDATE ... SET status1, updated_atCURRENT_TIMESTAMPInProgressArchived用户点击“完成并归档”UPDATE ... SET status2, end_timeNOW(), updated_at...InProgressRejected用户点击“驳回并说明”UPDATE ... SET status3, description新备注, updated_at...Archived—❌ 禁止任何变更拦截setData()并弹窗提示注意end_time仅在进入Archived时自动填充当前时间其他状态保持 NULL。这保证了“完成时间”是客观事实而非用户随意填写——这是审计溯源的关键依据。3.3 带时间约束的批量操作如何安全地“将本周所有待处理任务标记为进行中”用户常需批量操作但直接UPDATE WHERE status0 AND start_time ?有风险可能误触已过期任务。我们增加时间窗口校验// TaskRepository.cpp int TaskRepository::batchStartTasksInWeek(const QDate weekStart) { QSqlQuery query(m_db); query.prepare(R( UPDATE schedule_tasks SET status ?, updated_at CURRENT_TIMESTAMP WHERE status ? AND start_time ? AND start_time ? AND (end_time IS NULL OR end_time ?) )); query.addBindValue(static_castint(TaskStatus::InProgress)); query.addBindValue(static_castint(TaskStatus::Pending)); query.addBindValue(weekStart.toString(yyyy-MM-dd)); query.addBindValue(weekStart.addDays(7).toString(yyyy-MM-dd)); query.addBindValue(QDateTime::currentDateTime().toString(yyyy-MM-ddThh:mm:ss)); return query.exec() ? query.numRowsAffected() : 0; }参数说明weekStart是周一日期如2024-06-10第三个?确保只处理本周及之后开始的任务第五个?的end_time NOW()过滤掉已超期且未完成的任务避免把“昨天该做完却没做”的任务也标为“进行中”返回影响行数供 UI 显示“已启动 3 项任务”。4. 避坑本地事务日程开发中 4 个高频翻车点与后悔药4.1 现象QTableView 滚动时状态列图标闪烁偶现文字错位原因StatusDelegate::paint()中未正确处理option.state QStyle::State_Selected导致选中态与非选中态使用不同字体或对齐方式Qt 重绘时因缓存失效引发抖动。解决统一在paint()开头设置option.font.setPointSize(10)并在drawControl(QStyle::CE_ItemViewItem, option, painter)前调用option.rect.adjust(0,0,-2,0)修正图标右侧间距确保所有状态渲染宽度一致。4.2 现象添加新任务后QTableView 不自动滚动到底部新行被遮挡原因QStandardItemModel::appendRow()发出rowsInserted()信号但QTableView默认不监听此信号自动滚动。解决在模型插入后显式调用view-scrollToBottom()但需包裹在QTimer::singleShot(0, ...)中确保事件循环处理完插入后再滚动model-appendRow(items); QTimer::singleShot(0, view, [view]() { view-scrollToBottom(); });4.3 现象跨时区机器上start_time存入 SQLite 后读取显示为本地时间但比较逻辑错乱原因QDateTime::currentDateTime()返回本地时间而 SQLite 的CURRENT_TIMESTAMP是 UTC。混合使用导致时间基准不一致。解决全程统一用 UTC 时间。所有QDateTime创建时调用.toUTC()显示给用户前再.toLocalTime()转换QDateTime nowUtc QDateTime::currentDateTime().toUTC(); query.bindValue(:start_time, nowUtc.toString(yyyy-MM-ddThh:mm:ssZ)); // ISO8601 UTC 格式4.4 现象程序崩溃重启后部分任务updated_at时间早于created_at原因updated_at字段在建表时设为DEFAULT CURRENT_TIMESTAMP但 SQLite 的CURRENT_TIMESTAMP在 INSERT 时才计算而QSqlQuery::exec()执行 UPDATE 时若未显式设置updated_at会沿用旧值导致时间倒流。解决禁用DEFAULT CURRENT_TIMESTAMP所有INSERT/UPDATE语句中显式绑定updated_at值query.prepare(INSERT INTO schedule_tasks (..., updated_at) VALUES (?, ..., ?)); query.addBindValue(...); query.addBindValue(QDateTime::currentDateTime().toString(yyyy-MM-ddThh:mm:ss));5. 进阶技巧用 QSortFilterProxyModel 实现“动态事务看板”与离线搜索5.1 构建三层过滤链基础筛选 状态组合 时间范围真实场景中用户需要“看今天所有进行中的报销单”或“本月被驳回超过2次的任务”。我们不用写死 SQL而是用QSortFilterProxyModel叠加过滤// 主模型原始数据 QStandardItemModel *sourceModel new TaskModel(this); // 第一层代理按状态组合过滤支持多选 StatusFilterProxy *statusProxy new StatusFilterProxy(this); statusProxy-setSourceModel(sourceModel); // 第二层代理按时间范围过滤今日/本周/本月 TimeRangeFilterProxy *timeProxy new TimeRangeFilterProxy(this); timeProxy-setSourceModel(statusProxy); // 视图绑定最外层代理 ui-tableView-setModel(timeProxy); // 动态启用/禁用过滤 statusProxy-setFilterStatuses({TaskStatus::InProgress, TaskStatus::Pending}); timeProxy-setTimeRange(TimeRange::Today);TimeRangeFilterProxy::filterAcceptsRow()核心逻辑bool TimeRangeFilterProxy::filterAcceptsRow(int source_row, const QModelIndex source_parent) const { QModelIndex idx sourceModel()-index(source_row, START_TIME_COLUMN, source_parent); QString timeStr sourceModel()-data(idx, Qt::DisplayRole).toString(); QDateTime dt QDateTime::fromString(timeStr, yyyy-MM-dd hh:mm:ss); switch (m_range) { case Today: return dt.date() QDate::currentDate(); case ThisWeek: return dt.date() QDate::currentDate().startOfDay().addDays(-QDate::currentDate().dayOfWeek() 1) dt.date() QDate::currentDate().endOfDay().addDays(7 - QDate::currentDate().dayOfWeek()); // ... 其他范围 } return true; }5.2 离线全文搜索用 SQLite FTS5 实现毫秒级事务描述检索当任务量超 5000 条QSqlQuery::exec(SELECT * FROM ... WHERE description LIKE %关键词%)会明显卡顿。我们启用 SQLite 的 FTS5 全文搜索扩展-- 创建虚拟表需在打开数据库后执行一次 CREATE VIRTUAL TABLE IF NOT EXISTS tasks_fts USING fts5( title, description, contentschedule_tasks, content_rowidid ); -- 创建触发器保持同步 CREATE TRIGGER IF NOT EXISTS tasks_ai AFTER INSERT ON schedule_tasks BEGIN INSERT INTO tasks_fts(rowid, title, description) VALUES (new.id, new.title, new.description); END;搜索时不再查原表而是QSqlQuery searchQuery(m_db); searchQuery.prepare(SELECT s.* FROM schedule_tasks s JOIN tasks_fts f ON s.id f.rowid WHERE f MATCH ?); searchQuery.addBindValue(报销 AND 差旅); // 支持 AND/OR/NEAR提示FTS5 在 Qt 5.15 中默认启用无需额外编译选项。首次建表后用INSERT INTO tasks_fts(tasks_fts) VALUES(rebuild)重建索引可提升初始搜索速度。5.3 导出为标准 iCalendar (.ics) 文件让事务无缝接入系统日历用户常问“能不能导出到 Outlook” 我们不依赖第三方库手写符合 RFC5545 的 .ics 文件void TaskExporter::exportToICS(const QListTask tasks, const QString filePath) { QFile file(filePath); if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) return; QTextStream out(file); out BEGIN:VCALENDAR\nVERSION:2.0\nPRODID:-//MyApp//EN\n; for (const Task t : tasks) { out BEGIN:VEVENT\n; out UID: QUuid::createUuid().toString(QUuid::WithoutBraces) \n; out DTSTAMP: QDateTime::currentDateTime().toString(yyyyMMddThhmmssZ) \n; out DTSTART: t.startTime().toString(yyyyMMddThhmmssZ) \n; if (t.endTime().isValid()) { out DTEND: t.endTime().toString(yyyyMMddThhmmssZ) \n; } out SUMMARY: t.title().replace(\\, \\\\).replace(;, \\;).replace(,, \\,) \n; out DESCRIPTION: t.description().replace(\\, \\\\).replace(;, \\;).replace(,, \\,) \n; out STATUS: (t.status() TaskStatus::Archived ? CONFIRMED : TENTATIVE) \n; out END:VEVENT\n; } out END:VCALENDAR\n; file.close(); }参数说明DTSTAMP是事件创建时间UTCSUMMARY/DESCRIPTION中的\,;,,必须转义否则 Outlook 解析失败STATUS映射为 iCalendar 标准值确保系统日历正确显示状态。我坚持在每个新项目里先搭这个事务内核哪怕客户只要求“做个日历查看器”。因为真正的业务复杂度永远藏在“状态怎么变”、“时间怎么算”、“数据怎么找”里而不是“按钮放左边还是右边”。它不炫但每次重构都少踩三天坑——希望帮到你。本文还有配套的精品资源点击获取