1. 一套 C++/Qt 轻日历,为什么值得当成代码开发工具的练手样本
拿到这套轻日历源码,多数人的第一反应是直接点运行看界面,结果第一天就卡在工程跑不起来。它其实是一套用 C++/Qt 写界面、SQLite 存日程的桌面日历,核心代码按模块横向切开,从 main.cpp 进去只有一条五步启动链路:读设置、初始化日历引擎、打开数据库、加载主窗口、启动提醒线程。没有中间层,没有依赖注入框架,也没有一层套一层的抽象。对想找一套真正能改得动的代码开发工具样本的人来说,这种“瘦”反而是优点:你能在一小时内看清每个文件归谁管,也能在改坏之后迅速定位到是哪一段。下面从目录结构讲到二次开发,重点回答四件事:模块怎么切、启动顺序为什么不能乱、数据层怎么落地、改的时候哪里最容易翻车。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具视角下的目录:src 六个模块怎么切、谁依赖谁
读一套不熟悉的 C++/Qt 工程,先看目录比先看 main.cpp 划算。目录结构决定了你以后加功能时该往哪个文件夹放东西,也决定了编译错误会从哪个方向冒出来。这套轻日历没有用复杂的框架分层,就是按模块横向切,切得干净利落。
2.1 横向切模块:ui 与 core 的边界在哪
源码目录长这样:
text复制src/
main.cpp 程序入口,初始化单例
app/ 应用上下文,全局配置
ui/
mainwindow/ 主窗口框架
calendarwidget/ 月视图日历控件
scheduledialog/ 日程编辑弹窗
core/
datecalc/ 公历/农历换算,节假日计算
schedule/ 日程数据访问层,SQLite 封装
remind/ 提醒调度,系统托盘
res/ 图标、样式表、农历数据文本
这套切法的核心判断只有一条:能不能脱离窗口独立成立。datecalc 拿到一个日期就能算出农历和节假日,schedule 拿到一条日程就能写进库,remind 拿到一个时间点就能算出下次触发时刻,这三块都不需要窗口存在,所以归 core。反过来,mainwindow、calendarwidget、scheduledialog 三个目录脱离了 QWidget 就没有意义,归 ui。app 夹在两者之间,只放全局配置对象和单例入口,谁都可以引用它,但它不引用具体窗口。res 是纯资源,编译期被打进二进制,运行时按资源路径取。
| 目录 | 职责 | 对外暴露的东西 | 不该出现的东西 |
|---|---|---|---|
app/ |
应用上下文、全局配置 | 单例访问函数、配置读写接口 | 具体控件类型 |
ui/mainwindow/ |
主窗口框架、菜单、状态栏 | 主窗口类 | SQL 语句、农历算法 |
ui/calendarwidget/ |
月视图绘制、日期格子 | 日历控件类、选中日期信号 | 数据库连接 |
ui/scheduledialog/ |
日程编辑弹窗 | 弹窗类、表单取值 | 直接落库 |
core/datecalc/ |
公历农历换算、节假日 | 纯函数或轻量对象 | 任何 #include <QWidget> |
core/schedule/ |
SQLite 封装、日程增删改查 | 数据访问类、日程结构体 | 任何 #include <QWidget> |
core/remind/ |
提醒调度、托盘交互 | 调度器、触发信号 | 直接操作界面控件 |
这张表看起来是整理,实际是给二次开发划红线:只要新代码落在正确的格子里,后面就不会出现“改一个日期算法把主窗口编译搞崩”这种事。
2.2 main.cpp 的五步启动链路
整个程序的生死顺序都压在一个文件里。材料里写得很清楚:读取设置文件 → 初始化日历引擎 → 打开数据库 → 加载主窗口 → 启动提醒线程。这五步不是随便排的,顺序错了就会出现“界面起来了但提醒不响”或者“库还没打开,月视图已经在查数据”这类半死不活的状态。
一个能照着落地的骨架大致是这样:
cpp复制// main.cpp —— 五步启动链路,顺序不要调
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
// 第 1 步:读设置文件(INI),拿到窗口位置、视图模式、提醒开关
AppContext &ctx = AppContext::instance();
ctx.loadSettings();
// 第 2 步:初始化日历引擎,农历数据文本从 res 里读
ctx.initCalendarEngine();
// 第 3 步:打开 SQLite,建表并准备查询
if (!ctx.scheduleStore().open(ctx.databasePath())) {
return 1; // 库打不开就没有继续的意义
}
// 第 4 步:加载主窗口,此时库里已经有可用连接
MainWindow window;
window.restoreGeometryFrom(ctx.settings());
window.show();
// 第 5 步:最后启动提醒线程,它依赖前三步的成果
ctx.remindScheduler().start();
return app.exec();
}
逐句说清楚为什么这么排。第 1 步必须在最前面,因为后面所有模块都可能读配置:数据库路径可能来自配置,提醒开关也来自配置,restoreGeometryFrom 用的窗口位置同样来自配置。第 2 步排在第 3 步前面,是因为月视图一显示就会要求画出农历,引擎没就绪就会画出空白格。第 3 步排在窗口之前,是为了让 open() 的失败能在窗口出现之前就返回,避免用户看到一个空日历还以为程序正常。第 4 步的 show() 放在 restoreGeometryFrom 之后,否则窗口会先闪一下默认尺寸再跳到记忆位置。第 5 步放最后,是因为提醒调度要读数据库里的日程、要发托盘通知,这两个前提都在前面几步里。
这里有两个参数值得留意。databasePath() 一般由配置决定,常见做法是放在可执行文件同级目录或者用户配置目录,前者便于绿色运行,后者便于多用户隔离。restoreGeometryFrom 传入的是配置对象而不是硬编码尺寸,所以第一次运行时配置里没有值,需要有默认尺寸兜底,否则窗口可能以 0×0 出现,看起来像没启动。
提示:如果调试时发现提醒一次都不触发,先在第 5 步前面加一行日志打印当前时间,再在第 5 步后面打印调度器算出的下次触发时刻。两者对不上,多半是调度器拿的是 UTC 而界面显示的是本地时间。
2.3 依赖方向:core 不许反过来 include ui
这条规则材料里没明写,但从目录切法能直接推出来,而且它是整套工程能不能长期维护的分水岭。core 是数据与算法,ui 是表现层,依赖只能单向:ui 可以用 core,core 绝对不能用 ui。一旦 core/schedule/ 里出现 #include "mainwindow.h",编译顺序就会变成循环依赖,你改一个按钮颜色可能要重编整个数据层,更麻烦的是单元测试再也拉不起来,因为测试进程里没有窗口环境。
验证方法很土但很有效,在源码根目录跑一条命令:
bash复制# 在 core 目录里找有没有反向依赖 ui 的头文件引用
grep -rn --include="*.h" --include="*.cpp" \
-E '#include\s*"(mainwindow|calendarwidget|scheduledialog)' src/core/
# 顺便看一眼 core 里有没有混进 QtWidgets
grep -rn --include="*.h" --include="*.cpp" -E '#include\s*<Q(Widget|Dialog|MainWindow)' src/core/
两条命令都没有输出,说明边界干净。第一条命中,说明有人图省事在数据层里直接弹了对话框,正确做法是让 core 发一个信号或者返回一个错误码,由 ui 层决定弹什么。第二条命中,说明 core 混进了 QtWidgets 模块,这在只跑命令行测试的环境里会直接链接失败。我一般会把这两条命令写进提交前的检查脚本,比事后 review 靠眼睛扫靠谱得多。
3. 代码开发工具链落地:把 C++/Qt 工程从源码跑到窗口
目录看懂了,下一步是让它真的编译出来。这一步最容易消耗耐心,因为报错往往不是代码写错,而是工程文件、资源路径、运行目录三件事没对上。
3.1 工程文件最小配置:CMakeLists 里该有什么
这套工程按模块横向切,工程文件也应该按模块列源文件,而不是一句 file(GLOB_RECURSE ...) 把整个 src 扫进来。用通配符省事,但新增文件后不重新跑 CMake 就编译不到,排查起来非常费神。最小可用配置大致如下:
cmake复制cmake_minimum_required(VERSION 3.16)
project(light_calendar LANGUAGES CXX)
# 大版本按你本机装的 Qt 填,Qt5 和 Qt6 的组件名一致
find_package(Qt5 REQUIRED COMPONENTS Core Widgets Sql)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON) # 有 Q_OBJECT 的类必须开
set(CMAKE_AUTORCC ON) # res 下的 qrc 资源必须开
add_executable(light_calendar
src/main.cpp
src/app/appcontext.cpp
src/ui/mainwindow/mainwindow.cpp
src/ui/calendarwidget/calendarwidget.cpp
src/ui/scheduledialog/scheduledialog.cpp
src/core/datecalc/datecalc.cpp
src/core/schedule/schedulestore.cpp
src/core/remind/remindscheduler.cpp
src/res/resources.qrc
)
target_include_directories(light_calendar PRIVATE src)
target_link_libraries(light_calendar PRIVATE
Qt5::Core Qt5::Widgets Qt5::Sql)
三个开关的意思要说清楚。AUTOMOC 负责处理带 Q_OBJECT 宏的类,关掉之后所有信号槽都会报“undefined reference to vtable”,这是新手最常见的翻车点。AUTORCC 负责把 .qrc 编译进二进制,关掉之后图标和样式表会在运行时静默丢失,程序不崩但界面裸奔。target_include_directories 把 src 加进头文件搜索路径,这样代码里可以写 #include "core/schedule/schedulestore.h",而不是一长串 ../../。
如果团队习惯 qmake,.pro 文件里对应的是 QT += core widgets sql、SOURCES += 逐条列文件、RESOURCES += src/res/resources.qrc。两种方式选一种,别混用,混用会出现 moc 文件重复生成的问题。
3.2 资源与运行目录:res 下的图标、样式表、农历数据怎么进二进制
res/ 目录下有三类东西:图标、样式表、农历数据文本。前两类是界面观感,第三类是 datecalc 的输入数据。三者的共同点是都不应该依赖“程序从哪个目录启动”,否则你在 IDE 里跑正常,双击 exe 就变白板。
做法是统一走 qrc:
xml复制<!-- src/res/resources.qrc -->
<RCC>
<qresource prefix="/res">
<file>icons/app.png</file>
<file>styles/main.qss</file>
<file>data/lunar.dat</file>
</qresource>
</RCC>
代码里读取时用 :/res/... 形式的资源路径,不要用相对路径:
cpp复制// 样式表:从资源加载,换工作目录也不受影响
QFile qss(":/res/styles/main.qss");
if (qss.open(QIODevice::ReadOnly)) {
qApp->setStyleSheet(QString::fromUtf8(qss.readAll()));
}
// 农历数据:文本文件同样从资源读,路径固定
QFile lunar(":/res/data/lunar.dat");
if (!lunar.open(QIODevice::ReadOnly)) {
qWarning("农历数据缺失,月视图将只显示公历");
}
逻辑说明:setStyleSheet 要在主窗口构造之前或之后都可以,但必须在 show() 之前,否则用户会看到一帧无样式界面。农历数据在 initCalendarEngine() 里读一次就够,读进内存后 datecalc 的换算不再碰磁盘 io。参数上唯一要注意的是编码,QString::fromUtf8 是保守选择,如果数据文件是别的编码,中文会变成问号,这时候不要怀疑算法,先怀疑文件编码。
运行目录这件事也要提前定。调试时工作目录通常是构建目录,双击运行时是 exe 所在目录,两者不一样。凡是需要读写的东西,比如数据库文件、用户配置的 INI,都不要用相对路径,用 QCoreApplication::applicationDirPath() 拼绝对路径,或者干脆放到标准的用户配置目录。资源走 qrc 就没有这个问题,因为资源在二进制里面。
3.3 首次运行自检:四件事按顺序确认
工程编译通过只是第一步,窗口出来不代表程序正常。我一般按下面这个顺序确认,出问题时能快速缩小范围。
| 顺序 | 确认项 | 正常表现 | 异常时先看哪 |
|---|---|---|---|
| 1 | 配置文件生成 | 首次运行后在预期目录出现 INI | 路径是否用了相对路径 |
| 2 | 数据库打开 | 日志无 open 失败,库文件存在 | 目录是否有写权限 |
| 3 | 月视图渲染 | 日期格子齐全,农历有值 | qrc 是否编译进去 |
| 4 | 提醒线程 | 日志出现调度器启动,托盘有图标 | 是否在第 5 步之前启动 |
这个顺序的价值在于它是单向的:第 1 步不过,后面几步的报告都不可信。我见过有人跳过第 1 步直接查提醒为什么不响,查了半天发现配置文件根本没生成,数据库路径是空的,调度器拿不到任何日程。血泪经验就是先确认前置条件,再看现象。
4. 数据层怎么落:SQLite 表结构与日程读写封装
界面能跑起来之后,真正决定这套日历能不能用的就是数据层。core/schedule/ 这一层对外只暴露少量接口,内部把 SQLite 的连接、建表、语句准备都包起来,ui 层只管调函数拿结果。
4.1 schedule 模块的表设计:一张日程表够不够
轻日历的场景很窄:一条日程有标题、开始时间、结束时间、提醒开关、备注。没有参与人,没有附件,没有重复规则的高级展开。这个体量下一张表就够,拆成多张表只会让查询变复杂。
sql复制-- 日程主表:一条记录一个日程
CREATE TABLE IF NOT EXISTS schedule (
id INTEGER PRIMARY KEY AUTOINCREMENT,
title TEXT NOT NULL,
start_time TEXT NOT NULL, -- ISO8601 字符串,便于排序和范围查询
end_time TEXT NOT NULL,
remind_on INTEGER NOT NULL DEFAULT 1,
note TEXT DEFAULT ''
);
-- 按日期范围查日程是最高频的操作,给它建索引
CREATE INDEX IF NOT EXISTS idx_schedule_start
ON schedule(start_time);
字段选型有两点取舍。时间用 TEXT 存 ISO8601 而不是时间戳整数,是因为这个库要被人打开看,可读性比几个字节的存储更重要,而且 ISO8601 的字典序和时间序一致,BETWEEN 查询直接可用。remind_on 用整数 0/1 而不是布尔类型,是因为 SQLite 没有原生布尔,用整数最省事。索引建在 start_time 上,因为月视图每次翻页都是查一个月的范围,没有索引就是全表扫,日程一多翻页会明显卡顿。
4.2 SQLite 封装的四个动作:打开、建表、写入、按日查询
封装的原则是:连接归自己管,语句用预编译,错误往上抛而不是就地弹窗。下面这段是最小实现,能直接嵌进 core/schedule/schedulestore.cpp。
cpp复制// 打开数据库并建表,返回 false 表示后续所有操作都不该继续
bool ScheduleStore::open(const QString &dbPath)
{
m_db = QSqlDatabase::addDatabase("QSQLITE", "schedule_conn");
m_db.setDatabaseName(dbPath);
if (!m_db.open()) {
qWarning() << "open failed:" << m_db.lastError().text();
return false;
}
QSqlQuery q(m_db);
return q.exec("CREATE TABLE IF NOT EXISTS schedule ("
"id INTEGER PRIMARY KEY AUTOINCREMENT,"
"title TEXT NOT NULL,"
"start_time TEXT NOT NULL,"
"end_time TEXT NOT NULL,"
"remind_on INTEGER NOT NULL DEFAULT 1,"
"note TEXT DEFAULT '')");
}
// 写入一条日程,用占位符绑定,避免拼接字符串
bool ScheduleStore::insert(const ScheduleItem &item)
{
QSqlQuery q(m_db);
q.prepare("INSERT INTO schedule(title,start_time,end_time,remind_on,note)"
" VALUES(?,?,?,?,?)");
q.addBindValue(item.title);
q.addBindValue(item.startTime.toString(Qt::ISODate));
q.addBindValue(item.endTime.toString(Qt::ISODate));
q.addBindValue(item.remindOn ? 1 : 0);
q.addBindValue(item.note);
return q.exec();
}
参数说明:addDatabase 的第二个参数是连接名,必须显式给,否则多个模块各自 addDatabase 会互相覆盖默认连接,表现是“写着写着突然写到了另一个库”。prepare 加 addBindValue 的组合不只是防注入,还能让 SQLite 复用编译好的语句,批量插入时差别明显。时间统一用 Qt::ISODate 转字符串,和建表时的注释保持一致,别一处存本地格式一处存 UTC。
按日期范围查询是月视图的入口,写法也固定:
cpp复制// 查某个月的所有日程,区间左闭右开
QList<ScheduleItem> ScheduleStore::queryMonth(const QDate &firstDay)
{
QList<ScheduleItem> out;
QDate next = firstDay.addMonths(1);
QSqlQuery q(m_db);
q.prepare("SELECT id,title,start_time,end_time,remind_on,note"
" FROM schedule WHERE start_time >= ? AND start_time < ?"
" ORDER BY start_time");
q.addBindValue(firstDay.toString(Qt::ISODate));
q.addBindValue(next.toString(Qt::ISODate));
if (!q.exec()) return out;
while (q.next()) {
ScheduleItem it;
it.id = q.value(0).toInt();
it.title = q.value(1).toString();
it.startTime = QDateTime::fromString(q.value(2).toString(), Qt::ISODate);
it.endTime = QDateTime::fromString(q.value(3).toString(), Qt::ISODate);
it.remindOn = q.value(4).toInt() != 0;
it.note = q.value(5).toString();
out.append(it);
}
return out;
}
左闭右开这个细节值得单独说。用 >= 本月第一天 和 < 下月第一天,跨月边界的日程不会重复也不会漏。如果写成 <= 本月最后一天,那么 23:59:59 之后的记录会漏掉,而用日期字符串拼接时这个错误极难发现,因为大部分测试数据都落在白天。
4.3 datecalc 与 remind 的接口边界:日期换算不该碰数据库
datecalc 的职责只有一个:给一个公历日期,返回农历描述和是否节假日。它是纯计算,不读数据库,不碰界面,输入输出都是值类型。这个边界看起来理所当然,实际项目里特别容易被破坏:有人为了“顺便”把节假日配置存进数据库,让 datecalc 去查表,结果月视图第一次渲染时数据库还没打开,农历全部空白。
保持纯函数的写法,calendarwidget 在绘制每个格子时直接调用,不需要关心数据从哪来:
cpp复制// datecalc 对外只暴露这种签名,不接收数据库对象
struct DayInfo {
QString lunarText; // 农历描述
bool isHoliday; // 是否节假日
};
DayInfo DateCalc::infoFor(const QDate &date) const;
remind 的边界则相反,它必须读数据库,因为它要找出未来一段时间内 remind_on = 1 的日程,算出最近的一个触发时刻。但它读库的方式是通过 ScheduleStore 的接口,而不是自己拼 SQL。调度器内部一般是一个定时器加一个待触发队列,触发时发信号,由 ui 层决定是弹托盘还是弹窗。这条链路清楚之后,二次开发要加“提前 10 分钟提醒”,只需要改调度器算触发时刻的那一行,不用动数据库和界面。
5. 代码开发工具用错的地方:五个上手就翻车的排查记录
这一章是给已经动手改的人准备的。下面五条都是这套工程结构里天然存在的风险点,不是我编的故障,而是从模块划分和启动顺序里能直接推出来的坑。
5.1 提醒线程里直接改界面控件
现象:程序跑一段时间后随机闪退,日志里没有任何异常,调试器偶尔停在某个 QLabel::setText 上。
原因:core/remind/ 的调度器跑在独立线程里,触发提醒时如果直接拿到 ui 层的控件指针去改文字,就违反了 Qt 的线程亲和规则。控件只能在自己的线程里被修改,跨线程改可能当场崩,也可能跑很久才崩,属于典型的玄学问题。
解决:调度器只发信号,不碰控件。信号连接到主窗口的槽,用 Qt::QueuedConnection 保证槽在主线程执行。同时检查 core 目录里有没有 #include <QWidget>,有就说明边界已经破了,按第 2 章的命令扫一遍。
5.2 配置写进注册表或绝对路径,绿色运行失效
现象:在自己机器上窗口位置能记住,拷到另一台机器上全部重置,甚至连数据库都找不到。
原因:设置文件用 INI 是刻意的取舍,目的就是拷贝一个目录就能带走全部配置。一旦有人图省事改成写注册表,或者把 INI 路径写成开发机上的绝对路径,这个特性就废了。材料里明确写了配置只记录窗口位置、视图模式、提醒开关这几项,不存隐私数据,说明它本来就不需要系统级存储。
解决:INI 路径统一用 QCoreApplication::applicationDirPath() 拼接,或者放到用户配置目录;读取时先判断文件是否存在,不存在就用默认值并立即写回一份。验证方法是把整个运行目录拷到另一个路径下启动,看窗口位置和提醒开关是否还在。
5.3 core 里 include 了 ui,编译顺序变成死结
现象:改一个数据层函数,编译报 mainwindow.h 里的类型未定义;或者单元测试链接时出现一堆 QWidget 相关的未解析符号。
原因:core/schedule/ 为了弹一个“保存成功”的提示,直接引用了 ui 的头文件。依赖方向一反,core 就再也没法脱离窗口环境编译,测试进程里没有 QApplication,链接必然失败。
解决:core 只返回状态码或发信号,提示交给 ui。改完之后用第 2 章那两条 grep 命令复查,确认 src/core/ 下既没有 ui 头文件引用,也没有 QtWidgets 的 include。
5.4 多线程共用一个 SQLite 连接
现象:日程一多,保存时偶尔失败,lastError 里是 database is locked,重试一次又好了。
原因:SQLite 的连接对象不是线程安全的。主线程在写日程,提醒线程同时在查待触发列表,两个线程共用一个 QSqlDatabase 就会出现锁竞争。这套工程里恰好同时存在这两个访问点,所以这个坑几乎必踩。
解决:给提醒线程单独开一个连接,连接名不同,打开同一个库文件。写操作集中在主线程,读操作可以在各自线程的连接上做。如果写冲突仍然频繁,在 open() 之后执行一次 PRAGMA journal_mode=WAL;,让读写不互相阻塞。这个参数改的是库文件的行为,改完要重新打开连接才生效。
5.5 资源用相对路径,换工作目录图标全丢
现象:在 IDE 里运行图标和样式都正常,双击可执行文件启动后界面变成白底黑字,托盘图标也不显示。
原因:代码里用了 QPixmap("res/icons/app.png") 这种相对路径。相对路径是相对当前工作目录的,IDE 的工作目录通常是项目根目录,双击运行时是 exe 所在目录,两者不同,文件自然找不到。而且这种失败是静默的,QPixmap 加载失败只会得到一个空图,不报错。
解决:所有资源走 qrc,路径写成 :/res/...。检查方法是把可执行文件单独拷到一个空目录里运行,如果界面正常,说明资源真的编进二进制了;如果缺图标,回去看 AUTORCC 有没有开、.qrc 有没有加进 add_executable 的源文件列表。
6. 二次开发收口:给月视图加一个双击新建入口并验证到底
最后一个动作,拿一个真实的小需求把前面几章串起来:在月视图上双击某个日期,弹出日程编辑框,保存后当天格子出现标记。这个需求小到一下午能做完,但它同时穿过 ui、core、app 三层,正好用来检验边界有没有守住。
改动只有三处。第一处是 ui/calendarwidget/,在鼠标双击事件里把选中的日期发出去,不直接打开弹窗:
cpp复制// calendarwidget.cpp —— 只发信号,不关心谁接
void CalendarWidget::mouseDoubleClickEvent(QMouseEvent *e)
{
QDate hit = dateAt(e->pos()); // 由控件自己算出点中的是哪一天
if (hit.isValid())
emit dayDoubleClicked(hit);
}
第二处是 ui/mainwindow/,把信号接到打开弹窗的槽上,弹窗返回后调数据层保存,再通知月视图刷新:
cpp复制// mainwindow.cpp —— 编排,不写 SQL
connect(m_calendar, &CalendarWidget::dayDoubleClicked,
this, &MainWindow::onDayDoubleClicked);
void MainWindow::onDayDoubleClicked(const QDate &date)
{
ScheduleDialog dlg(date, this);
if (dlg.exec() != QDialog::Accepted) return;
ScheduleItem item = dlg.toItem(); // 弹窗只负责收集表单
if (m_ctx.scheduleStore().insert(item)) // 落库在 core
m_calendar->reloadMonth(date); // 刷新在 ui
}
第三处是 core/schedule/,不需要改,因为 insert 和 queryMonth 早就有了。这正是边界干净的好处:新功能只加在 ui,数据层一行不动。
验证按四步走,顺序不要跳:
| 步骤 | 操作 | 通过标准 |
|---|---|---|
| 1 | 双击一个空白日期,填标题保存 | 弹窗正常关闭,无报错 |
| 2 | 看当天格子 | 出现日程标记 |
| 3 | 关掉程序重新启动 | 标记仍在,说明真的落库了 |
| 4 | 把运行目录整体拷到别处再启动 | 标记和窗口位置都还在 |
第 4 步是我最看重的。它一次同时验证了三件事:数据库路径不是写死的绝对路径、INI 跟着目录走、资源编在二进制里。任何一项偷懒,这一步就会露馅。
这套工程我改过几轮之后养成一个习惯:每次动 core 之前,先把那两条 grep 命令跑一遍,确认依赖方向没被自己破坏;每次加完功能,把运行目录拷到别处启动一次,确认没有偷偷依赖开发机环境。这两件事加起来不到一分钟,省下的却是改板和回溯的后悔药。希望帮到你。
