Qt自助点餐系统开发实战：从触摸界面到断网补单与打印对接-北京尧图网络

简介QT自助点餐系统是一份面向C与Qt初学者、课程设计及桌面应用开发练习者的完整项目源码围绕餐饮场景实现菜单浏览、选菜下单与支付等交互流程帮助读者理解跨平台GUI程序的整体搭建思路。压缩包共23个文件约23KB包含6个cpp源文件、6个h头文件、4个ui界面文件、2个pro工程文件及qrc资源文件等分别承担业务逻辑、类声明、界面布局与工程配置结构紧凑便于通读。项目涉及QWidgets界面设计、MVC分层、QSql数据库连接、网络通信、事件处理、多线程、支付集成、国际化与日志记录等知识点并附带Client与Server两端模块可对照学习客户端与服务端协作方式。目前已有3836人学习下载适合作为Qt综合实践与软件工程能力提升的参考案例。1. 从一块触摸屏说起QT 自助点餐系统到底在解决什么问题很多人第一次接触 QT 自助点餐系统是在商场或食堂里那台竖着放的触摸屏前——点两下选好菜扫码付钱出票取餐。看起来简单但如果你是被安排去做这套系统的人真正要回答的问题不是“界面怎么画”而是一台没有键盘鼠标、可能还断网的机器怎么保证顾客从选菜到出票的整条链路不崩、不卡、不丢单。QT 自助点餐系统的本质是一个跑在嵌入式或桌面终端上的本地应用用 Qt 做界面和交互用本地数据库存菜单和订单再通过串口、USB 或网络把订单送到后厨打印机或收银台。它要解决的核心诉求有三个第一顾客操作路径要短点餐到支付最好控制在几步内第二断网时不能白屏得能继续点、继续存等网络恢复再补传第三界面要能适配不同尺寸的触摸屏从 10 寸到 21 寸都得能用。适合读这篇的人是已经会一点 C 或 Python、想用 Qt 做一个能真正跑起来的点餐终端而不是只画个界面交作业的开发者。下面我会按“先跑通最小闭环再补支付和打印最后处理断网和触摸适配”的顺序把参数、代码和踩坑点都摊开讲。2. 用 Qt 搭出点餐主界面从菜单列表到购物车的最小闭环2.1 为什么选 Qt Widgets 而不是 QML做自助点餐终端第一个选型问题就是 Qt Widgets 还是 QML。我一般会先看两个条件屏幕分辨率是否固定、动画需求是否多。如果终端是固定 1080×1920 竖屏菜单项以列表和网格为主动画只是按钮按下反馈那 Qt Widgets 更稳——控件成熟触摸事件处理直接调试时还能用 Qt Designer 拖布局。QML 的优势在流畅动画和自定义皮肤但点餐系统里真正需要动画的地方很少反而 QML 和 C 的数据交互会多一层胶水代码新手容易在信号槽上翻车。另一个现实原因是部署。Qt Widgets 编译出来的可执行文件依赖少在 ARM 板子上跑起来更省心QML 需要额外的 Qt Quick 运行时如果板子内存只有 512MB启动速度会明显变慢。所以我的默认建议是菜单展示、购物车、订单确认这三块用 Widgets 做如果后面要加广告轮播再单独嵌一个 QML 组件。2.2 菜单数据模型用 QSqlTableModel 还是自定义 QAbstractListModel菜单数据从哪来常见做法是本地 SQLite 存一份启动时读进内存。这里有两个选择直接用 QSqlTableModel 绑定 QTableView或者自己写一个 QAbstractListModel 再配 QListView。前者省代码但菜单项需要显示图片、价格、辣度标签时QSqlTableModel 的 delegate 会写得很别扭后者灵活但要多写几十行 rowCount、data、roleNames。我一般会选自定义 model因为点餐菜单的字段不止名称和价格还有图片路径、是否推荐、是否售罄、分类 ID。下面是一个最小可用的菜单 model 定义// menumodel.h class MenuModel : public QAbstractListModel { Q_OBJECT public: enum MenuRoles { NameRole Qt::UserRole 1, PriceRole, ImageRole, SoldOutRole }; explicit MenuModel(QObject *parent nullptr); int rowCount(const QModelIndex parent QModelIndex()) const override; QVariant data(const QModelIndex index, int role) const override; QHashint, QByteArray roleNames() const override; void loadFromDatabase(); // 从 SQLite 读取菜单 private: struct MenuItem { QString name; double price; QString imagePath; bool soldOut; }; QVectorMenuItem m_items; };逻辑说明rowCount 返回菜单项数量data 根据 role 返回对应字段roleNames 把角色名暴露给 QML 或 delegate。loadFromDatabase 里用 QSqlQuery 执行SELECT name, price, image, sold_out FROM menu WHERE category_id ?注意图片路径要存相对路径部署时把图片目录一起拷到终端上。参数说明SoldOutRole 用来控制“售罄”遮罩如果为 truedelegate 里画一层半透明灰色并禁用点击。价格用 double 存但显示时用 QString::number(price, f, 2)避免 9.9 显示成 9.899999。2.3 购物车逻辑数量增减、总价计算和清空购物车是点餐系统的核心状态。我见过不少新手把购物车直接塞进 QTableWidget每次增减都重新算一遍总价结果在触摸屏上快速连点时出现数量错乱。更稳的做法是用一个 QMapint, int 存“菜单 ID → 数量”再配一个信号通知界面刷新。// cartmanager.h class CartManager : public QObject { Q_OBJECT public: void addItem(int menuId, double price); void removeItem(int menuId); void clear(); double totalPrice() const; QListQPairint, int items() const; // menuId, count signals: void cartChanged(); private: QMapint, int m_counts; QMapint, double m_prices; // 缓存单价避免重复查库 };逻辑说明addItem 时如果 m_counts 里已有该 ID数量加一否则插入并记录单价。totalPrice 遍历 m_counts用 count 乘以 m_prices 里的单价累加。cartChanged 信号连接到界面的刷新槽每次增减都触发重绘。参数说明单价缓存 m_prices 很关键因为菜单价格可能在后台被改但顾客已经加进购物车的项应该按加购时的价格算。如果要求严格可以在下单时再查一次库做校验但界面显示用缓存价。2.4 触摸屏适配按钮最小尺寸和滚动区域触摸屏和鼠标最大的区别是手指点击精度。Qt 默认按钮在 10 寸屏上可能只有 30px 高手指根本点不准。我一般会把所有可点击控件的最小高度设成 48px宽度至少 80px间距 12px 以上。如果菜单项多用 QScrollArea 包住列表并开启setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff)靠手指滑动滚动。// 在 delegate 的 sizeHint 里设置 QSize MenuDelegate::sizeHint(const QStyleOptionViewItem option, const QModelIndex index) const { return QSize(option.rect.width(), 96); // 每项 96px 高 }逻辑说明sizeHint 决定每个菜单项占用的高度96px 在 1080p 竖屏上大约能放 10 项手指滑动两下就能看完。如果屏幕更小可以降到 72px但不要再低。参数说明滚动区域的setWidgetResizable(true)必须开否则列表不会随窗口缩放。另外在触摸屏上要禁用QScroller的默认惯性改成QScroller::grabGesture(scrollArea-viewport(), QScroller::LeftMouseButtonGesture)这样手指拖拽才跟手。3. 订单提交与支付对接本地队列、二维码和状态机3.1 订单本地持久化SQLite 表结构和写入时机订单不能只存在内存里否则程序一崩全丢。我一般会在 SQLite 里建两张表orders 存订单头order_items 存明细。写入时机是顾客点击“提交订单”后立刻插入状态先标为“待支付”支付成功再更新为“已支付”。CREATE TABLE orders ( id INTEGER PRIMARY KEY AUTOINCREMENT, order_no TEXT UNIQUE NOT NULL, total_price REAL NOT NULL, status INTEGER DEFAULT 0, -- 0待支付 1已支付 2已打印 3已取消 created_at TEXT DEFAULT (datetime(now, localtime)) ); CREATE TABLE order_items ( id INTEGER PRIMARY KEY AUTOINCREMENT, order_id INTEGER NOT NULL, menu_id INTEGER NOT NULL, menu_name TEXT NOT NULL, price REAL NOT NULL, count INTEGER NOT NULL, FOREIGN KEY(order_id) REFERENCES orders(id) );逻辑说明order_no 用时间戳加随机数生成比如QString::number(QDateTime::currentMSecsSinceEpoch()) QString::number(QRandomGenerator::global()-bounded(1000))保证唯一。status 字段是状态机的核心后面支付回调和打印回调都靠它判断。参数说明created_at 用 SQLite 的 datetime 函数自动填注意时区用 localtime否则终端时区不对会导致订单时间差 8 小时。外键约束在 SQLite 里默认关闭需要执行PRAGMA foreign_keys ON;。3.2 支付二维码的生成与轮询自助点餐的支付方式常见两种扫顾客的付款码或者屏幕上生成二维码让顾客扫。前者需要接扫码枪后者需要自己生成二维码并轮询支付结果。这里讲后者因为更通用。生成二维码可以用 qrencode 库Qt 里封装成 QImage 显示。轮询用 QTimer每 2 秒查一次支付网关的订单状态。// 生成二维码 QImage createQRCode(const QString orderNo, double price) { // 支付链接格式由网关决定这里用占位 QString payUrl QString(https://pay.example.com/qr?order%1amount%2) .arg(orderNo).arg(price); QRcode *qr QRcode_encodeString(payUrl.toUtf8().constData(), 0, QR_ECLEVEL_L, QR_MODE_8, 1); QImage image(qr-width, qr-width, QImage::Format_Mono); for (int y 0; y qr-width; y) { for (int x 0; x qr-width; x) { image.setPixel(x, y, (qr-data[y * qr-width x] 1) ? 0 : 1); } } QRcode_free(qr); return image.scaled(300, 300, Qt::KeepAspectRatio, Qt::FastTransformation); }逻辑说明QRcode_encodeString 把支付链接编码成二维码矩阵然后逐像素转成 QImage。注意 QR_MODE_8 支持中文参数如果链接里只有英文和数字用 QR_MODE_8 也没问题。参数说明QR_ECLEVEL_L 是最低纠错等级二维码图案最简单扫描成功率在屏幕上反而更高如果屏幕反光严重可以升到 QR_ECLEVEL_M。scaled 的 300×300 是显示尺寸实际生成后不要放大超过 400否则边缘模糊。轮询部分QTimer *pollTimer new QTimer(this); connect(pollTimer, QTimer::timeout, this, []() { QString status queryPayStatus(orderNo); // 发 HTTP 请求查状态 if (status paid) { pollTimer-stop(); updateOrderStatus(orderNo, 1); // 更新为已支付 emit paymentSuccess(orderNo); } else if (status expired) { pollTimer-stop(); showPayExpired(); } }); pollTimer-start(2000);逻辑说明每 2 秒查一次查到 paid 就停定时器并更新本地订单状态。如果 5 分钟没支付网关会返回 expired界面提示重新下单。参数说明轮询间隔不要低于 1 秒否则请求太频繁可能被网关限流也不要高于 5 秒顾客付完等太久会以为机器坏了。超时时间设 300 秒比较合理。3.3 支付回调与订单状态机订单状态从 0 到 3 的流转必须严格不能从“待支付”直接跳到“已打印”。我一般会写一个状态检查函数每次更新前先判断当前状态是否允许目标状态。bool canTransition(int from, int to) { static const QSetQPairint,int allowed { {0, 1}, {0, 3}, {1, 2}, {1, 3} }; return allowed.contains({from, to}); }逻辑说明0→1 是支付成功0→3 是顾客取消1→2 是打印完成1→3 是支付后取消退款场景。其他跳转一律拒绝。参数说明这个集合可以根据业务扩展比如加一个 2→3 表示打印失败取消。但不要允许 0→2否则会出现没付钱就出票的漏洞。4. 后厨打印与硬件对接串口、USB 和网络打印的取舍4.1 热敏打印机选型串口还是 USB后厨打印机常见三种接口串口RS232、USB、网口。串口最稳线长可以到 10 米但需要终端有串口或 USB 转串口USB 即插即用但 Linux 下权限和驱动容易出问题网口适合后厨离终端远的场景但需要配 IP。我一般优先选串口因为 Qt 的 QSerialPort 跨平台支持好代码简单。如果终端只有 USB就用 USB 转串口芯片CH340 或 CP2102在 Linux 下确认/dev/ttyUSB0存在。QSerialPort printer; printer.setPortName(/dev/ttyUSB0); printer.setBaudRate(9600); printer.setDataBits(QSerialPort::Data8); printer.setParity(QSerialPort::NoParity); printer.setStopBits(QSerialPort::OneStop); if (!printer.open(QIODevice::WriteOnly)) { qWarning() 打印机打开失败: printer.errorString(); return; }逻辑说明打开串口后用 write 发送 ESC/POS 指令。打印内容前先发\x1B\x40初始化打印机再发文本最后发\x1B\x64\x03走纸三行并切纸。参数说明波特率 9600 是热敏打印机默认值如果打印乱码先检查波特率是不是 19200 或 38400。数据位 8、无校验、1 停止位是标准配置不要改。4.2 ESC/POS 指令封装中文打印和排版ESC/POS 指令是打印机的事实标准但中文需要打印机支持 GBK 编码。Qt 的 QString 是 Unicode写入前要转成 GBK。QByteArray textToGbk(const QString text) { QTextCodec *codec QTextCodec::codecForName(GBK); return codec-fromUnicode(text); } void printOrder(const Order order) { QByteArray cmd; cmd.append(\x1B\x40); // 初始化 cmd.append(\x1B\x61\x01); // 居中 cmd.append(textToGbk(订单号 order.orderNo \n)); cmd.append(\x1B\x61\x00); // 左对齐 for (const auto item : order.items) { QString line QString(%1 x%2 %3\n) .arg(item.name).arg(item.count).arg(item.price * item.count, 0, f, 2); cmd.append(textToGbk(line)); } cmd.append(textToGbk(合计 QString::number(order.total, f, 2) \n)); cmd.append(\x1B\x64\x03); // 走纸 cmd.append(\x1D\x56\x00); // 切纸 printer.write(cmd); }逻辑说明\x1B\x61\x01是居中\x1B\x61\x00是左对齐。每行末尾加\n换行。切纸指令\x1D\x56\x00是全切如果打印机不支持切纸这行会被忽略。参数说明QTextCodec 在 Qt6 里移到了 core5compat 模块如果用的是 Qt6需要额外引入。或者直接用 QByteArray::fromLocal8Bit但依赖系统 locale不如显式指定 GBK 稳。4.3 打印失败重试与队列打印机可能缺纸、离线、卡纸不能因为一次失败就丢单。我一般会做一个打印队列每张订单打印失败后进队列每 10 秒重试一次最多重试 5 次。void PrintQueue::enqueue(const Order order) { m_queue.enqueue(order); if (!m_timer-isActive()) m_timer-start(10000); } void PrintQueue::onTimeout() { if (m_queue.isEmpty()) { m_timer-stop(); return; } Order order m_queue.head(); if (printOrder(order)) { m_queue.dequeue(); updateOrderStatus(order.orderNo, 2); // 已打印 } else { m_retryCount; if (m_retryCount 5) { m_queue.dequeue(); showPrintError(order.orderNo); // 提示人工处理 } } }逻辑说明队列用 QQueue 存订单定时器每 10 秒触发一次。打印成功就出队并更新状态失败累计重试次数超过 5 次出队并弹窗提示。参数说明重试间隔 10 秒是经验值太短会频繁占用串口太长后厨等得急。重试次数 5 次大约覆盖 50 秒足够处理换纸这种小故障。5. 避坑与排查触摸失灵、断网丢单和打印乱码5.1 触摸屏点击没反应但鼠标正常现象在终端上用手指点按钮没反应插鼠标点同一个按钮却正常。原因Qt 默认把第一次触摸当成鼠标事件但如果系统里同时存在触摸设备和鼠标设备Qt 可能把触摸事件过滤掉了。另外如果触摸屏驱动上报的是绝对坐标而 Qt 没开启对应属性也会出现点击偏移。解决在 main 函数里设置QCoreApplication::setAttribute(Qt::AA_SynthesizeMouseForUnhandledTouchEvents, true)确保触摸事件能转成鼠标事件。如果是坐标偏移用QT_QPA_EGLFS_NO_LIBINPUT1或检查 tslib 校准。更稳的做法是在终端启动脚本里加export QT_LOGGING_RULESqt.qpa.inputtrue看触摸事件有没有上报。5.2 断网后订单提交失败顾客已付款现象顾客扫码付了钱但终端因为断网没收到回调订单状态还是“待支付”后厨没出票。原因支付回调依赖网络断网时轮询请求超时但顾客手机端已经扣款。解决本地订单在提交时就写入 SQLite状态为“待支付”。网络恢复后启动一个补单线程把所有“待支付”且创建时间在 10 分钟内的订单重新查一次支付网关。如果网关返回已支付就更新状态并补打印。同时界面上要提示顾客“支付结果确认中请稍候”不要直接说失败。5.3 打印中文变成乱码或问号现象小票上中文显示成“???”或方块。原因打印机不支持 Unicode需要 GBK 编码但代码里直接 write 了 QString 的 UTF-8 字节。解决所有中文文本在写入串口前用 QTextCodec 转 GBK。如果打印机只支持 ASCII那就只能打拼音或英文这种情况在选型时就要确认。另外有些打印机需要发\x1B\x74\x00选择字符集具体看打印机手册。5.4 菜单图片加载慢界面卡顿现象滑动菜单列表时图片一张张蹦出来滑动不跟手。原因图片是原图直接加载没有缩略图每次 delegate 绘制都读磁盘。解决启动时把菜单图片统一缩放到 200×200 并缓存到内存delegate 里直接用 QPixmap 缓存。如果图片多用 QPixmapCache设置缓存上限 20MB。另外图片路径不要用网络地址本地文件读取最快。5.5 程序运行几天后内存涨到 1GB现象终端连续运行 72 小时后内存占用从 80MB 涨到 1GB最后被系统杀掉。原因订单列表、日志、图片缓存没有释放。常见的是每次刷新订单都 new 一个 model 但不 delete或者 QNetworkReply 没调 deleteLater。解决用 valgrind 或 Qt 的QObject::dumpObjectTree()排查泄漏。订单列表用分页加载不要一次查全部。日志文件按天切割超过 7 天自动删除。QNetworkReply 在 finished 信号里必须 deleteLater。6. 进阶技巧用 QSS 做触摸屏主题和远程配置下发6.1 QSS 主题让按钮在强光下也能看清自助点餐终端经常放在窗边或灯光直射的地方默认灰色按钮在强光下对比度不够。用 QSS 可以统一调整颜色和圆角而且不用改控件代码。QPushButton { background-color: #E63946; color: #FFFFFF; border-radius: 12px; font-size: 24px; min-height: 64px; min-width: 120px; } QPushButton:pressed { background-color: #B32B36; } QPushButton:disabled { background-color: #CCCCCC; color: #888888; }逻辑说明主按钮用高饱和红色按下时变深禁用时变灰。圆角 12px 在触摸屏上视觉更柔和但不要超过 20px否则边缘点击区域会变小。参数说明min-height 64px 是手指点击的舒适高度如果屏幕小可以降到 56px。font-size 24px 在 1080p 竖屏上大约占 3mm 高足够看清。QSS 文件可以放在资源文件里也可以运行时从外部加载方便现场调整。6.2 远程配置下发不改程序换菜单和价格终端部署到现场后菜单和价格经常变。如果每次都要重新编译运维成本太高。我一般会做一个远程配置接口终端启动时从服务器拉一个 JSON里面包含菜单分类、菜品、价格、图片 URL。本地 SQLite 只做缓存服务器是权威数据源。void ConfigLoader::fetchConfig() { QNetworkAccessManager *mgr new QNetworkAccessManager(this); QNetworkRequest req(QUrl(https://config.example.com/menu.json)); QNetworkReply *reply mgr-get(req); connect(reply, QNetworkReply::finished, this, []() { if (reply-error() QNetworkReply::NoError) { QByteArray data reply-readAll(); parseAndSaveToSqlite(data); // 解析 JSON 并更新本地库 emit configUpdated(); } reply-deleteLater(); }); }逻辑说明用 QNetworkAccessManager 发 GET 请求成功后解析 JSON 并写入 SQLite。界面监听 configUpdated 信号刷新菜单。如果请求失败继续用本地缓存不影响营业。参数说明JSON 里图片 URL 建议用 CDN 地址终端首次加载后缓存到本地。配置版本号要带上终端对比版本号决定是否更新避免每次启动都全量拉取。请求超时设 5 秒超时后走本地缓存。6.3 用日志定位现场问题分级输出和滚动文件现场出问题时不可能每次都远程调试。我一般会在终端上写日志文件按天切割保留最近 7 天。日志分三级INFO 记录订单和支付WARNING 记录打印失败和网络超时ERROR 记录崩溃和数据库异常。void customMessageHandler(QtMsgType type, const QMessageLogContext , const QString msg) { QString level; switch (type) { case QtDebugMsg: level DEBUG; break; case QtInfoMsg: level INFO; break; case QtWarningMsg: level WARN; break; case QtCriticalMsg: level ERROR; break; case QtFatalMsg: level FATAL; break; } QString line QString([%1] [%2] %3\n) .arg(QDateTime::currentDateTime().toString(yyyy-MM-dd hh:mm:ss)) .arg(level).arg(msg); QFile file(app.log); if (file.open(QIODevice::Append)) { file.write(line.toUtf8()); file.close(); } }逻辑说明在 main 函数里调用qInstallMessageHandler(customMessageHandler)所有 qDebug、qInfo、qWarning 都会走这个函数。日志按追加方式写入每天检查文件大小超过 10MB 就重命名归档。参数说明日志里不要打印顾客手机号或支付密码只打订单号和金额。文件路径用绝对路径比如/var/log/order/app.log避免工作目录变化导致找不到。如果终端磁盘小保留 3 天也够用。这套方案我从最小界面一路做到远程配置中间翻车最多的不是代码本身而是硬件兼容性和现场网络。我的习惯是每加一个硬件先写一个最小测试程序单独跑通再合进主程序每改一次数据库结构先在测试终端上跑 24 小时再推现场。希望帮到你。本文还有配套的精品资源点击获取

Qt自助点餐系统开发实战：从触摸界面到断网补单与打印对接

相关推荐

Scratch编程启蒙教学：从核心机制到项目实战的完整课程设计

51单片机流水灯实战教程

工业RFID如何落地智能制造产线：从频段原理到MES集成的技术拆解

更多资讯

字节缓冲区Buffer源码剖析：底层数组、读写偏移与切片引用安全

VBA开发者转xlwings：对象映射、避坑指南与企业级自动化升级

可执行文件装载与进程：虚拟地址空间和按需调页深度解析

全志T153接口能力解析：嵌入式中等带宽通信的‘刚刚好’方案

C# WCF与Web接口开发实战：从配置到跨域调用避坑指南

Tiptop与Easyflow系统集成避坑指南：从PDF样例到生产落地

今日更新

小波包能量谱原理与MATLAB实现：从频带分解到故障特征提取

基于LSTM的网易云音乐评论情感分析：数据清洗与模型调优实战

Alpha-Beta剪枝与极大极小值算法：博弈树搜索原理与实战优化

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？