1. 十字路口信号灯:拿 Qt5 练状态机,比拖控件划算
Qt5 这套 C++ 跨平台开发工具,多数人第一次接触都是拖几个按钮、连两条信号槽,界面能弹出来就放下了。真正让 Qt5 的手感长在身上的,是找一个有状态、有时序、又有界面刷新的小项目——十字路口信号灯模拟正好是这么个东西。它不依赖任何硬件,纯软件模拟东西南北四个方向的红黄绿灯按相位轮转,支持倒计时显示和状态切换,编译完直接在嵌入式 Linux 板上跑,改配时参数也不用动逻辑。适合两类人:刚摸 Qt5、想找个有画面感的项目练手的新手,和要在嵌入式 Linux 上快速验证信号灯状态机逻辑的开发者。下面从相位表怎么定、定时器怎么驱动、界面怎么刷新,一路写到板子上那几个绕不开的坑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 相位表先定死:四方向红黄绿的时序不是拍脑袋
十字路口信号灯看起来是「四个方向、十二个灯」,真按十二个灯去建模,很快就会掉进一个坑:每个灯一个布尔变量,切换时靠一堆 if 保证「东西绿的时候南北不能绿」,改一次配时就要把这些 if 全捋一遍。正确的切法是把它当成一个有限状态机,状态是「相位」,不是「灯」。这一章先把相位表这个地基打牢,后面所有代码都是围着它转。
2.1 别按灯建模,按相位建模
一个相位指的是路口在一个时间段内的稳定状态:四个方向所有灯的颜色都被唯一确定,只需要一个下标就能描述当前处于哪一段。东西放行是一个相位,东西黄灯过渡是另一个相位,南北放行、南北黄灯过渡各算一个,四个相位首尾相接成环,跑完一圈就是一个完整周期。
两种建模方式的差别,在改配时的时候最明显。按灯建模,你把东西绿灯从 20 秒改成 30 秒,南北红灯、南北绿、南北黄的起始时刻全都要跟着挪,任何一个 if 漏改,界面上就会出现两个方向同时绿的画面——在模拟器里只是难看,在真实路口是要出事的。按相位建模,绿灯时长只是相位表里的一个数字,红灯时长由其余相位累加得到,不存在「忘了同步」这回事。
还有一个隐性好处:相位建模天然适合做校验。启动时把所有相位时长加起来,等于周期;任一时刻只可能有一个相位在跑,冲突状态在数据结构层面就不存在,不需要靠运行时断言去兜底。这一点在你后面往状态机里加「夜间黄闪」「紧急全红」之类的特殊相位时,会省下大量判断。
2.2 四个相位怎么排:绿、黄、红,再换向
最基础的四相位循环,按「放行 → 过渡 → 换向放行 → 过渡」排。每个相位里所有方向的颜色都是写死的,不做运行时推导,这样调试时看一眼表就知道当前该是什么画面。
| 相位 | 东西方向 | 南北方向 | 时长 |
|---|---|---|---|
| 东西放行 | 绿 | 红 | 20s |
| 东西过渡 | 黄 | 红 | 3s |
| 南北放行 | 红 | 绿 | 20s |
| 南北过渡 | 红 | 黄 | 3s |
这张表里有两个数字是推导出来的,不单独配置:东西方向的红灯时长等于「南北放行 + 南北过渡」= 23 秒,南北方向的红灯时长等于「东西放行 + 东西过渡」= 23 秒,整个周期 46 秒。你只配绿灯和黄灯,红灯自动跟着变,这是相位建模最省心的地方。
黄灯时长别拍脑袋。3 秒是个常见值,它对应的是车辆在路口内的清空时间,和路口宽度、限速都有关系。模拟器里你可以随便调,但调的时候要意识到这是在模拟一个物理约束,不是纯粹的界面参数。如果你的路口比较宽,或者要模拟大车多的场景,把黄灯拉到 4~5 秒更接近现实。
还有一段很多简化实现会省掉:全红清空。在两个方向都红灯的瞬间插入 1~2 秒全红,确保上一相位最后一辆车完全驶出路口,下一相位才放行。要不要加取决于你验证的状态机有多细,加了之后相位从 4 个变 5 个,循环逻辑本身不用改,只是表里多一行。
2.3 用结构体把相位表写成数据
相位定了,接下来是把它落到代码里。原则只有一条:相位表是数据,不是逻辑。下面这段是控制器里最核心的定义,颜色和方向都用枚举,避免字符串比较,也避免魔法数字。
cpp复制enum class LightColor { Red, Yellow, Green };
enum class Direction { EastWest, NorthSouth };
enum class PhaseId { EwGreen, EwYellow, NsGreen, NsYellow };
struct PhaseStep {
PhaseId id;
LightColor ew; // 东西方向当前颜色
LightColor ns; // 南北方向当前颜色
int durationSec; // 该相位持续秒数
};
// 相位表:顺序即执行顺序,改配时只动 durationSec
static const QVector<PhaseStep> kPhasePlan = {
{ PhaseId::EwGreen, LightColor::Green, LightColor::Red, 20 },
{ PhaseId::EwYellow, LightColor::Yellow, LightColor::Red, 3 },
{ PhaseId::NsGreen, LightColor::Red, LightColor::Green, 20 },
{ PhaseId::NsYellow, LightColor::Red, LightColor::Yellow, 3 },
};
PhaseStep 里放的是「这个相位下两个方向各是什么颜色」和「持续多久」,而不是「哪个灯亮」。这样界面层拿到的永远是一对颜色值,不需要自己判断「现在东西是绿还是黄」。
kPhasePlan 用 QVector 而不是裸数组,是为了后面能从配置文件动态生成——静态初始化在这里只是给个默认值。顺序即执行顺序这一条要守住,不要在中间插一个靠 id 判断的分支,否则表就不再是唯一事实来源。
durationSec 用 int 秒而不是毫秒,是因为信号灯的配时本来就在秒级,用秒做单位读表时一眼能对上。真要更细的粒度,比如某些场景需要 0.5 秒级过渡,再考虑换成毫秒,但那时候倒计时的显示逻辑也要跟着改,不是单纯换个类型的事。
2.4 改配时只改表,不改逻辑
表写完之后,加一层启动校验,把「表本身就不合法」这种情况挡在运行之前。这一步在模拟器里看着多余,等你把参数交给别人改的时候就知道值了——有人会把黄灯改成 0,有人会把绿灯改成负数。
cpp复制bool validatePlan(const QVector<PhaseStep> &plan)
{
if (plan.isEmpty()) {
qWarning() << "相位表为空";
return false;
}
int total = 0;
for (const PhaseStep &step : plan) {
if (step.durationSec <= 0) {
qWarning() << "相位时长必须为正,当前:" << int(step.id)
<< step.durationSec;
return false;
}
if (step.ew == step.ns) {
qWarning() << "两方向颜色相同,存在冲突相位:" << int(step.id);
return false;
}
total += step.durationSec;
}
qInfo() << "相位表校验通过,周期" << total << "秒";
return true;
}
校验里做了三件事:空表直接拒、单个相位时长必须为正、同一相位下两个方向不能同色。第三条是防手滑的,正常情况下不会触发,但一旦有人把表改成数据驱动的,这条就是最后一道防线。
参数怎么设,给一组可以直接抄的起点值:
| 参数 | 含义 | 建议起始值 | 调整时注意 |
|---|---|---|---|
| 绿灯时长 | 单方向放行时间 | 20s | 主次干道不同,可分别设 |
| 黄灯时长 | 过渡清空时间 | 3s | 路口越宽取值越大 |
| 全红时长 | 双向红灯清空 | 0~2s | 加了相位表多一行 |
| 周期 | 四个相位之和 | 46s | 由表自动算出,不单独配 |
绿灯 20 秒是个中庸值,真实路口主干道常见 30 秒以上、支路 15 秒左右。你在模拟器里改这个数,唯一要盯的是倒计时显示别出现负数或者跳变——那是下一章定时器要处理的事。
3. QTimer 与信号槽:把相位轮转真正跑起来的四段代码
相位表是静态的,让它动起来靠的是 Qt5 的定时器和信号槽。这一章把控制器拆成四段:为什么选这种定时方式、类骨架长什么样、tick 进来之后做什么、以及怎么和界面解耦。四段连起来就是一个能跑的相位轮转。
3.1 1 秒 tick 还是链式 singleShot
让相位自动往下走,有两种常见写法。一种是每个相位结束时用 QTimer::singleShot 排下一个相位,形成一条链;另一种是开一个固定 1 秒的 QTimer,每次 tick 减一秒,减到零就切相位。两种都能跑,差别在误差和可维护性上。
| 对比项 | 链式 singleShot | 固定 1 秒 tick |
|---|---|---|
| 误差累积 | 每次调度都有延迟,越长越偏 | 单次 tick 有延迟,可校正 |
| 倒计时实现 | 要额外开定时器 | 天然对齐,直接减 |
| 暂停/恢复 | 要记录剩余时间再重排 | 停表即可,状态不丢 |
| 代码量 | 相位切换分散在回调里 | 集中在一个 onTick |
信号灯模拟里倒计时是刚需,链式写法等于要维护两套时间,一套驱动相位、一套驱动数字,两边稍微不同步就会出现「倒计时到 0 了灯还没变」。固定 tick 只有一套时间源,倒计时和相位切换用的是同一个计数,省掉一整类对不齐的问题。所以这里选 1 秒 tick。
选 tick 不等于忽略误差。QTimer 的语义是「至少间隔这么久触发」,不是「精确每隔一秒」,槽函数里干了重活,下一次 tick 就会晚到。这部分留到第 5 章展开,这里先把结构搭对。
3.2 TrafficController 的骨架
控制器只干三件事:持有相位表、维护当前相位和剩余秒数、在状态变化时发信号。它不碰任何界面对象,也不 include 任何 widget 头文件,这是后面能把它单独拎出来测试的前提。
cpp复制class TrafficController : public QObject
{
Q_OBJECT
public:
explicit TrafficController(QObject *parent = nullptr);
bool start(); // 校验相位表并启动
void pause();
void resume();
int cycleSeconds() const; // 一个完整周期时长
signals:
// 相位切换:通知界面整屏换色
void phaseChanged(PhaseId id, LightColor ew, LightColor ns, int durationSec);
// 倒计时变化:每秒一次
void countdownChanged(PhaseId id, int remainSec);
private slots:
void onTick();
private:
void enterPhase(int index);
void emitCurrent();
QVector<PhaseStep> m_plan;
QTimer *m_timer = nullptr;
int m_index = 0; // 当前相位下标
int m_remain = 0; // 当前相位剩余秒数
};
几个设计点值得说一下。m_index 和 m_remain 是两个独立状态,前者决定画面,后者决定数字,分开存是为了暂停时只停计时不动相位。phaseChanged 把颜色一起带出去,界面层不需要再回头查表,减少一次耦合。emitCurrent() 单独抽出来,是为了在 start() 和 resume() 里复用同一套「把当前状态推给界面」的逻辑,避免界面在暂停恢复后显示停留在旧值。
构造函数没什么花活,把定时器建好、相位表拷进来、连上自己的槽:
cpp复制TrafficController::TrafficController(QObject *parent)
: QObject(parent)
, m_plan(kPhasePlan)
, m_timer(new QTimer(this))
{
m_timer->setInterval(1000);
m_timer->setTimerType(Qt::CoarseTimer);
connect(m_timer, &QTimer::timeout, this, &TrafficController::onTick);
}
setTimerType(Qt::CoarseTimer) 是有意为之。精确定时器在嵌入式 Linux 上会频繁唤醒,功耗和调度开销都上去了,而信号灯配时对 1 秒内的抖动完全不敏感,粗定时器足够。这个选择在板子上跑一晚上就能看出差别。
3.3 onTick 与 enterPhase 的实现
onTick 是唯一改写相位状态的地方,逻辑要短到一眼能看完。它只做两件事:剩余秒数减一,减到零就进下一个相位;否则发倒计时信号。
cpp复制void TrafficController::onTick()
{
if (m_remain > 0) {
--m_remain;
emit countdownChanged(m_plan[m_index].id, m_remain);
}
if (m_remain == 0) {
enterPhase((m_index + 1) % m_plan.size());
}
}
void TrafficController::enterPhase(int index)
{
if (index < 0 || index >= m_plan.size())
return;
m_index = index;
const PhaseStep &step = m_plan.at(m_index);
m_remain = step.durationSec;
emit phaseChanged(step.id, step.ew, step.ns, step.durationSec);
emit countdownChanged(step.id, m_remain);
}
onTick 里先减再判断,顺序不能反。反过来的话,进入新相位的那一秒会多发一次倒计时,界面上表现为数字从 1 直接跳到 19,中间少一个 20。这种 off-by-one 在倒计时类需求里几乎必踩一次,写的时候就把顺序定死能省一轮调试。
enterPhase 里发完 phaseChanged 紧接着发一次 countdownChanged,是为了让界面在新相位的第一帧就拿到完整数字,而不是等下一秒 tick 才刷新。少了这一句,画面上会出现「灯变了但数字还是上一个相位的」这么一帧,肉眼能看出来。
(m_index + 1) % m_plan.size() 这个取模是循环的关键,表尾自动回到表头。相位表长度变了不用改这里,这也是把表做成数据的又一个好处。
3.4 信号槽怎么连、界面怎么解耦
控制器写完之后,界面那边只需要接两个信号。连接的代码放在 main.cpp 里,控制器和窗口对象都活到事件循环结束,不存在生命周期问题。
cpp复制int main(int argc, char *argv[])
{
QApplication app(argc, argv);
TrafficController controller;
TrafficWidget widget;
QObject::connect(&controller, &TrafficController::phaseChanged,
&widget, &TrafficWidget::onPhaseChanged);
QObject::connect(&controller, &TrafficController::countdownChanged,
&widget, &TrafficWidget::onCountdownChanged);
widget.showFullScreen();
if (!controller.start())
return 1;
return app.exec();
}
这里用的是函数指针版 connect,编译期就能检查信号和槽的签名是否匹配,写错参数类型直接编译不过,比字符串版少一类运行时才发现的问题。
showFullScreen() 在嵌入式 Linux 上要留意,eglfs 平台插件下没有窗口管理器,普通 show() 出来的窗口尺寸可能不是屏幕尺寸,全屏是更稳的做法。如果板子接的是 framebuffer,linuxfb 插件下同理。
控制器和界面之间没有互相持有指针,唯一的联系就是这两条连接。好处很实际:你可以在没有界面的情况下用 QCoreApplication 跑控制器,把每个相位的切换时刻打日志,验证时序对不对;也可以把界面换成一版纯文字的,控制器一行不改。这个解耦在项目小的时候看不出价值,等你要加个「按时间表切换配时方案」的功能时,就知道控制器里没有界面代码有多重要。
还有一个容易被忽略的点:controller.start() 放在 showFullScreen() 之后。先后顺序影响的是界面第一帧——控制器一启动就会发 phaseChanged,如果此时界面还没 show,槽函数照样会被调用,状态也能存下来,但第一帧的重绘会推迟到窗口真正显示时。放在后面能保证「窗口已经在了,信号才来」,调试时看到的画面和日志顺序是对得上的。
4. 倒计时与界面刷新:Qt5 事件循环下别在槽里干重活
界面这一层要处理的问题和控制器不一样。控制器关心的是「下一秒该谁亮」,界面关心的是「这一帧画什么、多久画一次」。Qt5 的重绘是事件驱动的,update() 只是往事件队列里投一个重绘请求,真正画是在事件循环回到空闲时。把这个机制搞明白,倒计时和灯的显示就不会出现撕裂或者卡顿。
4.1 倒计时的秒数从哪来:界面只存值,不算时间
界面层绝对不要自己开定时器算倒计时。一旦界面有了自己的时间源,就会出现两套时钟,一套来自控制器、一套来自界面,两者哪怕差几十毫秒,长时间跑下来也会漂开,表现就是「灯已经变了,数字还在跳上一个相位的」。
正确做法是界面只做一件事:收到 countdownChanged 就把值存下来,然后请求重绘。
cpp复制void TrafficWidget::onCountdownChanged(PhaseId id, int remainSec)
{
m_currentPhase = id;
m_remainSec = remainSec;
update(); // 投递重绘请求,不立即绘制
}
update() 和 repaint() 的区别要分清。update() 是异步的,多次调用会被合并成一次重绘,适合这种每秒一次、偶尔一帧内来两条信号的场景;repaint() 是同步立即绘制,在槽里调用会打断当前事件处理,除了极少数需要即时反馈的场合都不该用。倒计时用 update() 就够了,合并重绘还能省掉不必要的绘制开销。
m_remainSec 存的是控制器给的权威值,界面不参与计算。这条规矩守住之后,暂停、恢复、手动跳相位这些操作都不需要界面配合,控制器发什么就显示什么。
4.2 QLabel 拼字符串还是 QPainter 自绘
灯的图形和倒计时数字,可以用 QLabel 拼,也可以用 QPainter 画。两种方式在桌面端差别不大,在嵌入式 Linux 上要掂量一下。
| 对比项 | QLabel + 样式表 | QPainter 自绘 |
|---|---|---|
| 开发速度 | 快,摆好位置就行 | 慢,坐标要手算 |
| 圆形灯效果 | 要靠 border-radius 凑 | 直接 drawEllipse |
| 分辨率适配 | 样式表写死像素值 | 按控件尺寸比例算 |
| 重绘开销 | 每个控件独立重绘 | 一次 paintEvent 全画完 |
| 调试难度 | 布局问题靠猜 | 坐标可打印 |
信号灯是圆形色块加数字,用 QLabel 做圆形要靠 border-radius 等于宽度一半这种技巧,换个屏幕尺寸就得重调。自绘虽然要算坐标,但所有尺寸都从 width() 和 height() 推出来,一块代码适配所有分辨率。这里选自绘。
cpp复制void TrafficWidget::paintEvent(QPaintEvent *event)
{
Q_UNUSED(event);
QPainter painter(this);
painter.setRenderHint(QPainter::Antialiasing, true);
// 以控件短边为基准算灯半径,保证不同分辨率下比例一致
const int side = qMin(width(), height());
const int radius = side / 12;
const int gap = radius * 3;
// 东西方向画在左侧,南北方向画在右侧
drawSignalHead(painter, QPoint(width() / 4, height() / 2), radius, m_ewColor);
drawSignalHead(painter, QPoint(width() * 3 / 4, height() / 2), radius, m_nsColor);
// 倒计时数字画在中间
QFont font = painter.font();
font.setPixelSize(side / 8);
painter.setFont(font);
painter.drawText(rect(), Qt::AlignCenter, QString::number(m_remainSec));
}
paintEvent 里只做绘制,不查表、不算相位、不读文件。所有数据都来自成员变量,这些变量在槽函数里更新。这条边界守住了,重绘的快慢就只取决于绘制本身,不会被业务逻辑拖累。
radius 和 gap 从 side 推出来,而不是写死像素,是为了同一份代码在 800×480 的板和 1920×1080 的显示器上都能看。drawSignalHead 是个辅助函数,按传入的颜色把红黄绿三个圆画出来,亮的用实色、灭的用暗色,这里不展开。
QString::number(m_remainSec) 每秒构造一次字符串,开销可以忽略。如果哪天要显示「东西 15 秒 / 南北 23 秒」这种复合文本,也别在 paintEvent 里拼,挪到槽里拼好存起来,绘制函数保持纯粹。
4.3 重绘节奏:update() 不是越多越好
Qt5 的重绘是合并的,一帧内调十次 update() 和调一次效果一样,但这不代表可以随便调。每次 update() 都要走一遍事件投递,在嵌入式板子上事件队列的处理能力有限,高频投递会挤占其他事件的处理时间。
倒计时的天然节奏是 1 秒一次,和 tick 对齐,不存在高频问题。真正要注意的是相位切换那一帧:phaseChanged 和紧随其后的 countdownChanged 会各触发一次 update(),两次调用在一帧内被合并成一次重绘,这是期望行为,不用手动去重。
如果你在调试时发现重绘次数异常多,常见原因是把 update() 写进了 resizeEvent 或者某个被频繁触发的槽里,形成了「重绘 → 布局变化 → 再重绘」的循环。判断方法很简单:在 paintEvent 开头打一行计数日志,跑十秒看总数,正常应该是十几次,上百次就说明有循环。
4.4 全屏、字体与资源加载
嵌入式 Linux 上还有两个界面层的琐事要处理:全屏和字体。
全屏前面提过,showFullScreen() 比 show() 稳。如果板子有多个显示输出,还要确认 Qt 选的是哪一个,这个通过平台插件的参数控制,不在代码里写死。
字体是中文界面必踩的坑。桌面环境里系统字体齐全,板子的根文件系统往往只带一套英文字体,汉字渲染出来全是方块。稳妥的做法是把字体打进 Qt 资源文件,启动时显式加载,不依赖系统装了什么。
cpp复制int main(int argc, char *argv[])
{
QApplication app(argc, argv);
// 从 Qt 资源加载字体,避免依赖板子上的系统字体
int fontId = QFontDatabase::addApplicationFont(":/fonts/ui.ttf");
if (fontId >= 0) {
const QStringList families = QFontDatabase::applicationFontFamilies(fontId);
if (!families.isEmpty())
app.setFont(QFont(families.first(), 14));
}
// ... 其余初始化
}
addApplicationFont 返回 -1 表示加载失败,通常是资源路径写错或者字体文件没打进 qrc。applicationFontFamilies 拿到的家族名才是 setFont 要用的,直接写字体文件名是不行的。这一段放在 QApplication 构造之后、窗口创建之前,保证界面第一次绘制就用上正确字体。
字体文件本身建议用思源黑体这类开源字体,体积控制在一个字重就够,别把整个字体家族都塞进资源,板子的存储空间通常不宽裕。
5. 嵌入式 Linux 跑 Qt5 的避坑清单:五个翻车现场与它们的解法
代码在桌面上跑通,拷到板子上是另一回事。下面五条是我在板子上实际撞过的,每条按现象、原因、解决写,顺序大致就是第一次部署会遇到的顺序。
5.1 一运行就报 libQt5Widgets.so.5 找不到
现象:交叉编译一路绿灯,可执行文件拷到板子上执行,终端立刻报 error while loading shared libraries: libQt5Widgets.so.5: cannot open shared object file: No such file or directory,程序连 main 都没进去。
原因:交叉编译时链接的是宿主 sysroot 里的 Qt 库,板子上只有根文件系统自带的基础库,没有这套 Qt 运行库;或者库已经拷过去了,但不在动态链接器的默认搜索路径里,加载器找不到。
解决:把工具链 sysroot 里 Qt 的 lib 目录整体同步到板子上,比如 /opt/qt5/lib,然后二选一——启动脚本里导出 LD_LIBRARY_PATH=/opt/qt5/lib,或者在链接时加 -Wl,-rpath,/opt/qt5/lib 把路径写进可执行文件。后者更省事,不依赖启动环境,代价是路径变了要重新链接。用 ldd 在板子上跑一遍可执行文件,缺哪个库一目了然,比逐个猜快得多。
5.2 程序起来了,屏幕全黑,串口刷 EGL 报错
现象:进程活着,ps 能看到,但屏幕黑的,串口里反复打印 EGL Error: Could not create the EGL surface 之类的信息。
原因:Qt5 在嵌入式 Linux 上默认走 eglfs 平台插件,这个插件要求板子有可用的 GPU 驱动和 EGL/GLES 支持。驱动没配好、/dev/fb0 权限不对、或者环境变量 QT_QPA_PLATFORM 指向了一个板子不支持的插件,都会卡在创建 surface 这一步。
解决:先用 framebuffer 验证程序逻辑是否正常,命令行加 -platform linuxfb 或设 QT_QPA_PLATFORM=linuxfb。如果 linuxfb 下能正常显示,说明代码没问题,问题在 eglfs 的驱动配置上,再回头查 GPU 驱动和权限;如果 linuxfb 也黑,那就是绘制逻辑本身的问题,和平台插件无关。这个二分能把排查范围砍掉一半。
5.3 中文全变成方块
现象:界面能出来,灯也正常,但所有中文标签、倒计时旁边的说明文字全是空心方块。
原因:板子的根文件系统里没有中文字体,Qt 的字体匹配找不到能渲染汉字的项,只能退化到方块。
解决:按 4.4 的做法把字体打进 Qt 资源,启动时用 addApplicationFont 显式加载,不依赖系统字体。如果不想改代码,也可以把字体文件放到板子的 /usr/share/fonts 下,让 fontconfig 扫到,但这种方式在精简过的根文件系统上不一定生效,前者更可控。加载完之后打个日志确认 applicationFontFamilies 返回非空,别等看到方块才发现加载失败。
5.4 倒计时越跑越慢,跑一晚上差出好几分钟
现象:程序刚启动时倒计时和手机秒表对得上,跑几个小时后明显偏慢,一晚上下来能差出好几分钟,相位切换的节奏也跟着整体后移。
原因:QTimer 的 1 秒是「至少 1 秒」,不是精确 1 秒。onTick 里如果除了更新状态还干了别的事——写日志、读配置、等锁——事件循环被占住,这次 tick 就晚到,而晚到的时间不会在下次补回来,误差只累不减。
解决:别用「每次减一」的方式算剩余时间,改成用真实经过时间算。进入相位时用 QElapsedTimer 记一个起点,onTick 里用 elapsed() 算出真实过了多少毫秒,再折算成剩余秒数。这样即使某次 tick 晚到,下一次也能自己纠正回来。同时把 onTick 里的重活挪走,日志改成异步或者降低频率,槽函数只保留状态更新和发信号。
cpp复制void TrafficController::onTick()
{
// 用真实经过时间校正,避免 tick 延迟累积
const qint64 elapsedMs = m_phaseClock.elapsed();
const qint64 totalMs = qint64(m_plan[m_index].durationSec) * 1000;
const int remainSec = qMax(0, int((totalMs - elapsedMs + 999) / 1000));
if (remainSec != m_remain) {
m_remain = remainSec;
emit countdownChanged(m_plan[m_index].id, m_remain);
}
if (elapsedMs >= totalMs)
enterPhase((m_index + 1) % m_plan.size());
}
enterPhase 里要对应地调一次 m_phaseClock.restart()。加 999 再除 1000 是向上取整,保证剩余时间不为零时显示的是「还有几秒」而不是提前显示 0。
5.5 改个绿灯时长要重新交叉编译一遍
现象:想把东西绿灯从 20 秒改成 25 秒,得改代码、重新交叉编译、重新拷贝、重启程序,一轮下来好几分钟,调参调得人心态崩。
原因:相位表写成了 static const 全局数组,编译期就固化了,运行时没有任何入口能改。
解决:把相位表挪到配置文件,用 QSettings 读 ini,启动时加载,加载失败再退回代码里的默认值。改完 ini 重启程序即可生效,不用重新编译。下一章把这个改造完整写一遍。
6. 配时参数搬出代码:QSettings 与一次 24 小时验证
把相位表从代码里搬出来,改动量比想象中小。QSettings 读 ini 是 Qt5 自带的能力,不需要引入任何第三方库,配置文件放在可执行文件同目录,现场改参数的人不用懂代码。
cpp复制QVector<PhaseStep> loadPlanFromIni(const QString &path)
{
QSettings settings(path, QSettings::IniFormat);
// 读绿灯和黄灯时长,红灯由相位关系自动推导,不单独配
const int ewGreen = settings.value("phase/ewGreenSec", 20).toInt();
const int ewYellow = settings.value("phase/ewYellowSec", 3).toInt();
const int nsGreen = settings.value("phase/nsGreenSec", 20).toInt();
const int nsYellow = settings.value("phase/nsYellowSec", 3).toInt();
QVector<PhaseStep> plan = {
{ PhaseId::EwGreen, LightColor::Green, LightColor::Red, ewGreen },
{ PhaseId::EwYellow, LightColor::Yellow, LightColor::Red, ewYellow },
{ PhaseId::NsGreen, LightColor::Red, LightColor::Green, nsGreen },
{ PhaseId::NsYellow, LightColor::Red, LightColor::Yellow, nsYellow },
};
if (!validatePlan(plan)) {
qWarning() << "配置文件相位表非法,回退到默认值";
return kPhasePlan;
}
return plan;
}
settings.value 的第二个参数是默认值,配置文件缺项时不会返回 0,这一点很关键——少了默认值,一个拼错的键名就会让某个相位时长变成 0,直接被 validatePlan 拦下来,程序起不来,现场排查成本很高。
路径用 QCoreApplication::applicationDirPath() + "/traffic.ini" 拼,不要用相对路径。板子上的启动脚本工作目录不一定是可执行文件所在目录,相对路径读不到文件时会静默退回默认值,表现是「改了 ini 没生效」,这种问题查起来最费时间。
改造完之后,验证方法也要跟着变。我一般会做两件事:一是把每个相位的进入时刻用 qInfo() 打出来,跑一个完整周期,肉眼核对四个时刻的间隔是不是和 ini 里写的一致;二是让程序连续跑 24 小时,第二天早上用 QElapsedTimer 记录的累计时长和系统时间对一下,差值在几秒以内算过关,差出分钟级就说明 tick 校正那部分没生效,回去查 5.4。
还有一个习惯:每次改完配时,先用一个周期的日志确认相位顺序没乱,再看倒计时数字有没有跳变。顺序错了是表的问题,数字跳变是 tick 的问题,两者分开查,比盯着屏幕猜快得多。
从那以后我每次把这类模拟程序往板子上部署,都会先跑一遍 ldd 确认库齐、再用 linuxfb 确认绘制正常、最后才切回目标平台插件,这三步走完再谈性能。希望帮到你。
