1. Qt 6.8 LTS 与 Qt for MCUs 2.9 双版本发布,嵌入式与桌面开发迎来哪些实质变化
Qt 6.8 LTS 和 Qt for MCUs 2.9 在同一时间窗口发布,这个节奏本身就值得关注。前者是桌面端、嵌入式 Linux、移动端的主力框架,后者是面向微控制器(MCU)的轻量级图形方案,两条产品线同时更新,意味着从高端 SoC 到低端 MCU 的图形应用开发链路正在被进一步打通。如果你正在做工业 HMI、车载仪表、智能家居面板、医疗设备界面,或者单纯是一个长期用 Qt 写桌面工具的开发者,这次更新里都有你需要关心的东西。
Qt 6.8 是继 6.2、6.5 之后的第三个 LTS 版本。LTS 意味着官方会提供更长时间的支持周期,对于商业项目来说,选 LTS 版本几乎是默认动作,因为你不希望产品量产之后还要频繁跟着非 LTS 版本升级。Qt for MCUs 2.9 则把 Zephyr RTOS 作为正式支持的平台之一,这个信号很明确:MCU 上的 GUI 开发不再只绑定在裸机或者 FreeRTOS 上,Zephyr 生态的开发者可以直接把 Qt 的图形能力引入自己的项目。
这篇文章会从版本定位、核心变化、实操迁移、常见问题几个角度展开,重点放在“为什么这么选”和“实际怎么用”上。无论你是刚接触 Qt 的新手,还是已经用 Qt 5.15 做了多年项目的老手,都能从中找到可以直接参考的内容。
1.1 为什么 LTS 版本对商业项目如此重要
先聊一个很多人容易忽略的问题:为什么 Qt 的 LTS 版本值得单独拿出来说。Qt 的版本节奏大致是每年两个非 LTS 版本,每隔一段时间出一个 LTS。非 LTS 版本的支持周期短,通常只有几个月到一年左右,而 LTS 版本会获得长达数年的补丁支持。对于商业项目,尤其是工业控制、医疗、汽车这些生命周期动辄五到十年的领域,你不可能每隔半年就升级一次框架版本,因为每次升级都意味着回归测试、驱动适配、第三方库兼容性验证。
Qt 6.8 LTS 的定位就是给这些长周期项目提供一个稳定的基线。它包含了 Qt 6.x 系列积累下来的所有改进,同时冻结了 API 的破坏性变更。你在 6.8 上开发的产品,后续可以持续获得安全补丁和关键 bug 修复,而不需要被迫迁移到新版本。这一点和 Qt 5.15 LTS 当年的角色是一样的,只不过 5.15 已经进入维护末期,新项目再选 5.15 就不太明智了。
从实际项目经验来看,我建议新项目直接上 6.8 LTS,老项目如果还在 5.15,可以规划一个迁移窗口。迁移的痛点主要集中在 QML 的语法变化、模块拆分、以及构建系统从 qmake 到 CMake 的切换。这些后面会详细说。
1.2 Qt for MCUs 2.9 支持 Zephyr RTOS 意味着什么
Qt for MCUs 和桌面版 Qt 是两套不同的技术栈。桌面版 Qt 依赖操作系统提供的窗口系统、内存管理、文件系统等能力,而 MCU 上通常没有这些,资源也极其有限,RAM 可能只有几百 KB,Flash 只有几 MB。Qt for MCUs 用的是 QML 的一个子集,配合专门的运行时和渲染引擎,把图形界面的内存占用和 CPU 开销压到极低。
Zephyr RTOS 是一个开源实时操作系统,在物联网和嵌入式领域增长很快,社区活跃,支持的芯片和开发板非常多。Qt for MCUs 2.9 正式支持 Zephyr,意味着你可以在一套 Zephyr 工程里同时管理任务调度、通信协议和图形界面,不需要为了 GUI 单独切到另一个 RTOS 或者裸机环境。对于已经在用 Zephyr 做产品固件的团队,这个组合能省掉很多集成工作。
不过要注意,Qt for MCUs 的授权模式和桌面版不同,商业使用需要确认许可证类型。另外,Zephyr 的支持目前主要覆盖特定的开发板和芯片系列,不是所有 Zephyr 支持的平台都能直接跑 Qt for MCUs,选型时要先查官方支持列表。
2. Qt 6.8 LTS 核心变化拆解与迁移实操
Qt 6.8 的变化很多,但真正影响日常开发的集中在几个方面:构建系统、QML 运行时、图形渲染后端、以及模块的增减。下面按实际迁移时会遇到的顺序来讲。
2.1 构建系统:CMake 已经是唯一推荐路径
如果你还在用 qmake,Qt 6.8 里 qmake 虽然还能用,但官方已经明确推荐 CMake。Qt 6 系列从 6.0 开始就把 CMake 作为一等公民,6.8 里大部分新特性和示例工程都是基于 CMake 的。qmake 在 6.8 中仍然存在,但一些新模块的集成配置在 qmake 下会变得别扭。
迁移一个典型的 qmake 工程到 CMake,核心是几件事。原来的
.pro
文件里的
QT += widgets
这类写法,在 CMake 里变成
find_package(Qt6 REQUIRED COMPONENTS Widgets)
加
target_link_libraries(myapp PRIVATE Qt6::Widgets)
。源文件列表、头文件路径、资源文件(.qrc)的写法也都有对应变化。
cmake_minimum_required(VERSION 3.16)
project(MyApp LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)
find_package(Qt6 REQUIRED COMPONENTS Widgets SerialPort)
add_executable(MyApp
main.cpp
mainwindow.cpp
mainwindow.h
resources.qrc
)
target_link_libraries(MyApp PRIVATE
Qt6::Widgets
Qt6::SerialPort
)
这段配置里,
AUTOMOC
、
AUTORCC
、
AUTOUIC
分别处理 moc 元对象编译、资源文件编译和 UI 文件编译,对应 qmake 里自动处理的那部分。
SerialPort
模块的引入方式也顺便演示了,因为热词里有人问
unknown module in qt:serialport
,这个问题在 CMake 下通常是因为没有在
find_package
里声明对应组件,或者 Qt 安装时没有勾选该模块。
注意:从 qmake 迁移到 CMake 时,最容易漏掉的是
target_include_directories和target_compile_definitions,qmake 里INCLUDEPATH和DEFINES的对应项要逐一核对,否则会出现找不到头文件或者条件编译分支不对的问题。
2.2 QML 运行时与工具链的改进
Qt 6.8 对 QML 的编译和运行做了不少优化。QML 的
qmllint
、
qmlformat
、
qmlcachegen
这些工具在 6.8 里更成熟了,尤其是
qmlcachegen
对 QML 的预编译支持,能明显减少启动时的解析开销。对于界面复杂、QML 文件多的项目,开启 QML 编译缓存是值得做的优化。
具体做法是在 CMake 里用
qt_add_qml_module
来组织 QML 模块,它会自动处理 QML 文件的编译和资源嵌入。相比以前手动把 QML 塞进 qrc,这种方式更规范,也更容易做增量编译。
qt_add_qml_module(MyApp
URI MyApp
VERSION 1.0
QML_FILES
Main.qml
components/Card.qml
components/Slider.qml
)
这样配置之后,QML 文件会被编译进可执行文件,运行时不需要再从文件系统加载,启动速度和部署便利性都更好。热词里有人提到“用 qt 左右平滑滑动的卡片列表”,这种场景用 QML 的
ListView
配合
Flickable
或者
SwipeView
就能实现,6.8 里这些组件的性能和手势处理都有改进。
2.3 图形渲染后端与绘图效率
Qt 6 默认使用 RHI(Render Hardware Interface)作为图形抽象层,支持 OpenGL、Vulkan、Metal、Direct3D 等多种后端。6.8 里 RHI 的稳定性和性能继续提升,尤其是在嵌入式 Linux 上,对 EGLFS 和 LinuxFB 平台插件的支持更完善。
关于绘图效率,热词里有人问“qt 绘图效率比较”和“qchart 实现图片缩放”。Qt Charts 模块在 6.8 里仍然是独立模块,使用前需要在安装时勾选或者在 CMake 里声明
Charts
组件。对于大量数据点的曲线刷新,把数据采集和界面刷新放在不同线程是常见做法,Qt 的信号槽跨线程连接默认是队列连接,可以安全地把后台线程的数据推到主线程渲染。
// 后台线程采集数据,通过信号发送到主线程
connect(workerThread, &Worker::dataReady,
this, &MainWindow::updateChart,
Qt::QueuedConnection);
Qt::QueuedConnection
确保槽函数在主线程执行,避免在非 GUI 线程直接操作界面对象。这是 Qt 多线程编程的基本规则,但实际项目里仍然经常有人踩坑,表现为随机崩溃或者界面卡死。
2.4 模块增减与常见编译错误
Qt 6.8 里一些模块的位置和名称有调整。比如 Qt SerialPort 从 Qt 5 到 Qt 6 一直是独立模块,但安装时如果没勾选,编译时就会报
unknown module(s) in qt: serialport
。解决办法是在 Qt 维护工具里补装该模块,或者在 CMake 里确认
find_package
声明正确。
另一个常见问题是版本混用,比如热词里的
cannot mix incompatible qt library (5.15.3) with this library (5.15.2)
。这个错误通常是因为系统里存在多个 Qt 版本,运行时链接到了错误的库。排查方法是检查
LD_LIBRARY_PATH
环境变量,以及用
ldd
查看可执行文件实际链接的 Qt 库路径。在开发机上,建议用 Qt Creator 的 Kit 配置来隔离不同版本,不要依赖系统全局的 Qt。
| 常见错误 | 典型原因 | 解决方向 |
|---|---|---|
| unknown module in qt:serialport | 安装时未勾选 SerialPort 模块 | 用维护工具补装,或 CMake 声明组件 |
| cannot mix incompatible qt library | 多版本 Qt 库混用 | 检查 LD_LIBRARY_PATH,用 Kit 隔离 |
| QML module not found | QML 模块路径未配置 | 检查 qt_add_qml_module 和 import 路径 |
| 编译通过但运行崩溃 | 非 GUI 线程操作界面 | 用 QueuedConnection 跨线程通信 |
3. Qt for MCUs 2.9 与 Zephyr RTOS 集成实操
Qt for MCUs 的目标平台和桌面 Qt 完全不同,开发流程也不一样。这一部分讲清楚从环境搭建到界面部署的完整链路。
3.1 工具链与开发环境准备
Qt for MCUs 的开发通常需要几个东西:Qt for MCUs SDK、对应的芯片工具链、以及目标开发板。2.9 版本支持 Zephyr 之后,你还需要 Zephyr 的 SDK 和 west 构建工具。Zephyr 的工程管理用 west,它是一个类似 repo 的多仓库管理工具,能拉取 Zephyr 内核、HAL、以及各种模块。
安装顺序建议是:先装 Zephyr SDK 和 west,确认能用
west build
编译一个官方示例,比如 blinky,确保工具链没问题。然后再装 Qt for MCUs SDK,把 Qt 的运行时和 Zephyr 工程集成。这个顺序很重要,因为 Zephyr 本身的工具链配置就比较繁琐,如果先装 Qt 再调 Zephyr,出问题时分不清是哪一层的毛病。
Qt for MCUs 的 QML 代码和桌面 QML 有差异,它只支持 QML 的一个子集,很多桌面端的组件和 JavaScript 特性不可用。写界面时要参考 Qt for MCUs 的文档,确认用到的 QML 类型在支持列表里。这一点新手容易忽略,直接拿桌面 QML 往 MCU 上搬,结果编译报一堆不支持的属性。
3.2 Zephyr 工程中集成 Qt 图形模块
在 Zephyr 工程里集成 Qt for MCUs,核心是把 Qt 的库和头文件路径加入 Zephyr 的构建系统。Zephyr 用 CMake 作为构建系统,所以集成方式是在
CMakeLists.txt
里引入 Qt for MCUs 提供的 CMake 配置。
# 在 Zephyr 工程的 CMakeLists.txt 中
find_package(QtForMCUs REQUIRED)
target_link_libraries(app PRIVATE
QtForMCUs::QtForMCUs
)
同时需要在
prj.conf
里开启 Zephyr 的显示驱动、内存配置等选项。MCU 上跑图形界面,内存是最紧张的资源。Qt for MCUs 的渲染引擎会尽量复用缓冲区,但你还是需要根据屏幕分辨率和色深计算帧缓冲大小。比如一个 480x272 的 16 位色屏幕,单帧缓冲就是 480 * 272 * 2 = 261120 字节,约 255 KB。如果芯片 RAM 只有 512 KB,那留给应用逻辑的空间就很有限了。
提示:在 MCU 上做图形界面,优先考虑降低色深和分辨率,而不是一味追求视觉效果。16 位色(RGB565)在大多数工业 HMI 上已经够用,比 32 位色省一半内存和带宽。
3.3 界面部署与性能调优
Qt for MCUs 的界面部署方式取决于目标平台。对于 Zephyr,通常是把编译好的固件通过调试器烧录到开发板。调试阶段可以用 J-Link 或者 OpenOCD,配合 GDB 做单步调试。图形界面的调试比较特殊,因为你看不到中间变量,更多依赖日志输出和屏幕实际显示效果。
性能调优方面,MCU 上的瓶颈通常是渲染帧率和内存带宽。Qt for MCUs 提供了几种渲染模式,比如直接渲染到帧缓冲、双缓冲、以及部分区域刷新。部分区域刷新只更新屏幕上变化的区域,能显著降低带宽消耗,适合界面变化不频繁的场景。开启方式是在 QML 里合理使用
visible
属性控制元素显隐,而不是频繁重建整个界面。
另外,动画在 MCU 上要谨慎使用。桌面端流畅的 60fps 动画,在 MCU 上可能只有 15fps,因为 CPU 主频和内存带宽都差很多。如果产品需要动画效果,建议用 Qt for MCUs 提供的优化过的动画类型,并且控制动画区域的大小。
4. 常见问题与排查技巧实录
这一部分整理实际开发和迁移过程中高频遇到的问题,以及排查思路。很多问题在官方文档里不会写,但实际项目里几乎都会遇到。
4.1 Qt 6.8 迁移中的典型坑
从 Qt 5 迁移到 Qt 6.8,最大的变化是模块拆分和 API 调整。Qt 5 里很多类在 Qt 6 里换了头文件或者命名空间。比如
QString
的一些方法签名变了,
QRegExp
被
QRegularExpression
取代,
QTextCodec
被移除,编码转换改用
QStringConverter
。这些变化在编译时就会报错,逐个改就行,但量大。
QML 方面的变化更隐蔽。Qt 6 的 QML 引擎对类型的要求更严格,以前能隐式转换的地方现在可能报错。比如
width: "100"
这种字符串赋给数值属性的写法,在 Qt 6 里会警告甚至报错。迁移时建议开启
qmllint
,把警告都清掉,能提前发现很多问题。
还有一个常见问题是第三方库的兼容性。如果你的项目依赖某个只支持 Qt 5 的第三方库,迁移到 Qt 6.8 时要么找替代库,要么自己适配。适配的工作量取决于库对 Qt 的依赖程度,如果只是用了 QString 和 QDebug 这类基础类,改动不大;如果深度依赖 Qt 5 的图形或者网络模块,可能就比较麻烦。
4.2 MCU 端内存与性能问题排查
MCU 上跑 Qt for MCUs,最常见的问题是内存不足导致运行崩溃或者界面显示异常。排查时先看链接阶段的 map 文件,确认静态分配的内存占用。然后看运行时的堆栈使用,Zephyr 提供了
kernel stacks
和
kernel threads
的 shell 命令,可以查看各线程的栈使用情况。
如果界面刷新卡顿,先确认帧率目标是否合理。MCU 上不要期望 60fps,30fps 甚至 15fps 在很多场景下是可以接受的。然后检查是否有不必要的重绘,比如整个界面在定时器里频繁刷新。Qt for MCUs 的 QML 引擎有脏区域检测,但前提是你的界面结构合理,没有大范围的属性频繁变化。
| 问题现象 | 可能原因 | 排查手段 |
|---|---|---|
| 界面显示花屏 | 帧缓冲配置错误 | 检查色深和分辨率设置 |
| 运行一段时间后崩溃 | 内存泄漏或栈溢出 | 查看 map 文件和线程栈使用 |
| 刷新卡顿 | 重绘区域过大或帧率过高 | 优化 QML 结构,降低刷新频率 |
| 触摸无响应 | 输入驱动未配置 | 检查 Zephyr 的输入设备配置 |
4.3 安装与版本管理经验
热词里大量出现“qt 离线安装包下载”“qt 国内镜像”“qt 安装教程”这类词,说明安装和下载是很多人的痛点。Qt 官方安装器需要在线下载组件,网络不稳定时体验很差。离线安装包是官方提供的完整包,下载后可以离线安装,适合网络受限的环境。
版本管理方面,强烈建议用 Qt Creator 的 Kit 机制来管理多个 Qt 版本。每个 Kit 对应一个 Qt 版本和一套编译器,项目切换 Kit 就能切换 Qt 版本,不需要改系统环境变量。这样能避免前面提到的版本混用问题。对于团队开发,建议把 Qt 版本和 Kit 配置写进项目文档,确保所有人环境一致。
另外,Qt 6.8 的安装器里,模块是按需勾选的。如果你不确定需要哪些模块,可以先装基础模块,后续用维护工具补装。但要注意,补装模块后需要重新运行 CMake 配置,否则
find_package
可能找不到新模块。
4.4 跨平台开发中的平台差异处理
Qt 的跨平台能力是它的核心卖点,但实际项目中,平台差异仍然需要处理。比如文件路径分隔符、换行符、系统字体、屏幕 DPI 这些,在不同平台上表现不同。Qt 提供了
QDir
、
QFile
等类来屏蔽大部分差异,但涉及系统 API 调用时,还是需要条件编译。
#ifdef Q_OS_WIN
// Windows 特定代码
#elif defined(Q_OS_LINUX)
// Linux 特定代码
#elif defined(Q_OS_MACOS)
// macOS 特定代码
#endif
在 Qt 6.8 里,
Q_OS_*
宏仍然可用,但建议尽量用 Qt 提供的跨平台 API,减少条件编译。条件编译越多,维护成本越高,测试覆盖也越难做。
对于嵌入式 Linux 和桌面 Linux 的差异,主要是显示后端和输入设备的不同。嵌入式 Linux 通常用 EGLFS 或者 LinuxFB,桌面用 X11 或者 Wayland。Qt 6.8 对这些平台插件的支持都比较成熟,但配置方式不同,部署时要确认目标平台的插件是否正确安装。
5. 从选型到落地:一个工业 HMI 项目的完整参考路径
把前面的内容串起来,给一个实际项目的参考路径。假设你要做一个工业 HMI,主控是嵌入式 Linux 板子,同时有一个低成本的 MCU 子模块负责简单的状态显示。
主控这边选 Qt 6.8 LTS,用 CMake 构建,QML 做界面,C++ 做业务逻辑。通信模块用 Qt SerialPort 或者 Qt Network,取决于设备接口。界面用
qt_add_qml_module
组织,开启 QML 编译缓存。多线程处理数据采集,用 QueuedConnection 更新界面。部署时用 EGLFS 平台插件,直接渲染到帧缓冲,不依赖桌面环境。
MCU 子模块选 Qt for MCUs 2.9 加 Zephyr RTOS,界面用 Qt for MCUs 支持的 QML 子集,控制在 480x272 分辨率、16 位色。内存预算按帧缓冲加应用逻辑来分配,留足余量。调试用 J-Link,性能调优开启部分区域刷新。
两个模块之间的通信可以用串口或者 CAN,协议自己定义。Qt 这边用 SerialPort 或者 CAN 模块,Zephyr 那边用对应的驱动。通信数据的解析和界面更新要解耦,避免通信阻塞导致界面卡顿。
这个路径里的每一步都有坑,但整体是可行的。关键是前期把版本选型定好,环境搭好,后面就是按部就班地开发和调试。Qt 6.8 LTS 和 Qt for MCUs 2.9 的组合,覆盖了从高端到低端的图形应用需求,对于做嵌入式图形产品的团队来说,是一个值得投入时间研究的技术栈。
我在实际项目里踩过的比较深的坑是 QML 编译缓存的配置。一开始没开,界面加载明显偏慢,尤其是 QML 文件多的时候。开了之后启动时间大概能减少三分之一。另一个坑是 MCU 上的内存计算,第一版没算帧缓冲,直接按桌面思维分配,结果跑起来就崩。后来把色深从 32 位降到 16 位,分辨率也降了一档,才稳定下来。这些经验在文档里不会写,但实际做的时候一定会遇到。
207



被折叠的 条评论
为什么被折叠?



