做Qt开发这几年我经常在技术社区里看到一类提问qt弹出对话框选择文件、qt时域图转换为频域图,使用qcustomplot显示、qcoreapplication::exec() 之后就无法捕获了。这些问题单个看都不难但串起来就是一个Qt开发者最真实的成长路径从搭环境、做界面到读文件、开线程再到画波形、算频谱最后打包发布还得应付各种崩溃。这篇是Qt基础篇的第七篇我不打算按文档顺序讲而是用一个非常典型的上位机小工具把这些知识点串起来。小工具的功能很朴素点按钮选一个数据文件读完以后在界面上画出时域波形再点一下对这段数据做FFT把频谱图也画出来整个读取和计算过程放在后台线程界面不能卡死最后用发布工具打包能在一台没装Qt的电脑上直接跑。看完这篇你不仅能复现这个工具还能顺带搞清楚Qt的元对象系统、信号槽、事件循环、多线程、qcustomplot和kissfft集成以及发布和崩溃处理这些核心问题。1. 先看看大家都在搜什么1.1 高频搜索词背后的七个典型问题把热词表拉出来看Qt相关的提问其实高度集中。第一类是环境安装类包括qt下载、qt安装、qt creator安装、qt 5.15.2下载安装、卸载qt这类问题占了很大比例说明很多人在第一步就卡住了。第二类是工程配置类比如在vs code中如何规范qt项目、用vs打开qt的项目qt的文件都找不到这在跨平台开发和团队协作时特别常见。第三类是界面交互类比如qt弹出对话框选择文件、qt获取文件信息、qt好看的等待提示框。第四类是绘图与算法类比如qt时域图转换为频域图、使用qcustomplot显示、qchart实现图片缩放、qt绘制三维曲线。第五类是事件与线程类比如qt多线程、qt中的消息队列、qcoreapplication::exec() 之后就无法捕获了。第六类是发布与稳定性类比如qt发布软件、qt崩溃、qt中使用breakpad。第七类是扩展集成类比如qt怎么调用halcon、qt加载焊缝并选择提取焊缝、qt自动更新开发。这些搜索词叠在一起能看出一个很典型的心态大家学Qt基础不是想学孤立的概念而是想做出一个能用的东西。一个能把数据读进来、画成波形、算出频谱最后还能发给别人的桌面小工具几乎能覆盖上述大部分痛点。1.2 一个例子串起所有知识点所以我这篇干脆从一个信号采集与频谱显示小工具入手。这个工具对应的场景在工业上位机开发里很常见从某个数据文件或设备里拿到一串采样点先在时域看原始波形再做FFT看频域特征。你只需要掌握四件事Qt工程怎么建、qcustomplot怎么引入、QThread怎么把耗时计算放到后台、kissfft怎么接进来做频谱转换。在此基础上发布打包和崩溃捕获这两个进阶话题会一并处理因为它们才是让你从自己跑得动到别人也跑得动的关键台阶。2. 环境搭建从版本选择到交叉编译2.1 Qt版本与安装器选择Qt版本选择没有太多玄学如果你没有特殊需求直接用5.15.2这个LTS版本。它在开源用户里覆盖率最高网上能查到的问题和答案也最多。安装时不需要把整个套件全选Windows下通常只需要勾选MinGW 8.1.0 64-bit和MSVC 2019 64-bit中的其中一个。我个人做法是MinGW留一个、MSVC留一个MinGW发给学生和爱好者用很方便因为不需要装Visual StudioMSVC留在正式项目里用因为和VS的调试器、性能分析工具配合更好。安装器本身是联网下载网速不好的时候会非常考验耐心。如果下载卡住可以试试用清华或中科大的镜像把在线安装器的下载源指过去或者找验证过的离线安装包。另外安装目录绝对不要带中文和空格这是很多人踩过的第一个坑。后面编译第三方库或者做交叉编译时路径里有空格会引发一堆莫名其妙的问题排查起来非常浪费时间。2.2 三种编辑器工作流环境搭好之后下一步是选工作流。最省心的是Qt Creator它自带的qmake和CMake支持、调试器集成、UI Designer都很成熟。但有些人已经习惯了Visual Studio或VSCode这里分两种情况看。如果你用VS打开Qt项目发现qt的文件都找不到多数不是文件丢了而是打开方式错了。VS不认识.pro文件。如果项目是qmake体系需要先在Qt Creator或命令行里让qmake生成VS工程或者干脆用CMake重写工程然后用VS打开CMakeLists.txt。至于在vs code中如何规范qt项目核心是装好C插件和CMakeTools插件再用CMakePresets.json指定Qt的CMAKE_PREFIX_PATH。VSCode本身不负责编译它只负责编辑和定位错误构建还是要靠CMake。我的建议是个人学习用Qt Creator团队开发如果坚持VSCode就老老实实用CMake一条路走到黑。2.3 引入qcustomplotqcustomplot严格说不是一个库而是两个文件qcustomplot.h和qcustomplot.cpp。从官网拿到这两个文件后直接拖进工程即可。qmake工程把它们加进SOURCES和HEADERSCMake工程就加到target_sources里。很多新手以为qcustomplot需要编译成动态库其实完全没必要源码编译进你的程序里更省事。唯一的缺点是头文件比较大编辑器智能提示会稍慢一点。qcustomplot的API设计得很Qt风创建一个QCustomPlot控件放到界面上调用addGraph()添加曲线用graph(0)-setData(x, y)设置数据最后调replot()重绘。它底层提供了QCPGraph、QCPAxis这些类缩放、平移、鼠标取点都有现成接口。这也是为什么时域图转频域图这种需求在Qt社区里基本都会推荐qcustomplot而不是自己拿QPainter慢慢画。2.4 交叉编译到底在做什么交叉编译这个词对刚入门嵌入式Qt的人来说很劝退但拆开看并不复杂。开发板上的程序不是把源码复制过去现场编译而是在开发机上用一套交叉编译工具链把程序编译成目标架构能识别的二进制再把二进制和依赖的Qt库拷贝到开发板。Qt的交叉编译核心是qmake的spec文件比如ARM平台要指定arm-linux-gnueabihf-g再配合qtbase里预先配置好的交叉编译参数。这一步水深涉及sysroot、链接器路径、qmake.conf的修改。基础篇里只需要记住一个结论交叉编译的难点不是Qt本身而是目标平台工具链。你只要保证开发机上能编译出x86的Qt程序再拿到一个官方提供或社区验证过的交叉编译脚本按脚本走就能生成开发板可运行文件。真正容易出问题的不是代码而是库依赖不齐、Qt模块没编全、glibc版本冲突。前期调试尽量用开发板厂家提供的Qt库比自己从头编译整套Qt要省心得多。3. 元对象系统、信号槽与消息循环的底层逻辑3.1 没有moc就没有信号槽Qt和其他C框架最大的区别就是元对象系统。你在类里写Q_OBJECT宏Qt在编译前会多运行一个叫moc的程序对这个类做预处理生成一个moc_xxx.cpp文件。这个文件里包含类的元信息类名、父类、信号列表、槽列表、属性列表。运行时connect函数实际是通过这些元信息来匹配信号和槽的。所以你会发现如果某个类忘了加Q_OBJECT信号槽就会失灵而且编译报错非常奇怪比如未定义的引用 vtable。这就是因为moc没有给这个类生成元对象代码。我给大家一条纪律凡是自己写的QObject子类不管有没有自定义信号都老老实实加上Q_OBJECT。这一条能省掉大量排查时间。3.2 connect的三种写法connect函数在Qt5以后有很多种写法我建议分三阶段掌握。第一阶段用SIGNAL/SLOT宏connect(sender, SIGNAL(valueChanged(int)), receiver, SLOT(onValueChanged(int)));这种写法的优点是直观缺点是槽名写错了只有运行时报错编译期不拦你。第二阶段用函数指针connect(sender, SenderClass::valueChanged, this, ReceiverClass::onValueChanged);编译期就能检查参数是否匹配这是Qt5推荐写法。第三阶段用lambda适合处理短逻辑connect(sender, SenderClass::valueChanged, this, [](int value){ ui-label-setText(QString::number(value)); });但lambda默认捕获this时有一个风险如果接收者已经销毁lambda里再操作this就是悬空指针。稳妥的做法是在连接时使用上下文对象或者在lambda内先做有效性判断。很多信号槽没反应的问题都出在连接类型上。默认情况下同一个线程里的信号槽是直接调用跨线程是队列调用。直接调用就像普通函数调用发信号的一方会等槽函数执行完才返回队列调用则把槽函数放进接收者所在线程的事件循环里异步执行。如果接收者所在线程没有事件循环队列连接的槽函数就永远不会执行。这个知识点在下一部分会反复用到。3.3 exec()之后到底发生了什么很多人在程序里写这样的代码int ret app.exec(); // 下面的代码很少被执行到或者以为在exec()之后注册崩溃捕获就能捕获崩溃。实际上从exec()返回的那一刻Qt事件循环已经退出正常Qt程序生命周期到这里就结束了。崩溃往往不是发生在exec()之后而是发生在事件循环内部的某个事件处理过程中。崩溃信号由操作系统直接接管根本不经过你代码里的try/catch。所以breakpad这类崩溃捕获库的初始化一定要放在exec()之前而且崩溃处理函数里只能做最简单的事比如把崩溃上下文写到文件然后立即退出。exec()本身的作用是启动一个事件循环。事件循环可以理解为一个不停从事件队列里取事件、分发事件的循环。鼠标点击、键盘输入、定时器超时、跨线程信号队列连接这些都会变成事件挂到队列里。只要这个循环在跑程序就能持续响应外部操作。如果你在某个按钮的槽函数里写一个while(1)事件循环就被堵住了界面立刻假死。这也是为什么耗时的操作不能放在主线程的根本原因。3.4 消息队列与跨线程通信Qt里的消息队列和操作系统层面的消息队列不太一样它更多指QEvent加上QCoreApplication::postEvent()这套事件分发机制。signal/slot在跨线程时本质上就是往接收者所在线程的事件队列里post一个QMetaCallEvent。还有一个常见误解是所有跨线程都该用信号槽。不一定跨线程也可以用QMutex保护共享数据或者用QMetaObject::invokeMethod把方法调用切到目标线程。但信号槽是最Qt味的写法也最容易避免手动加锁带来的死锁问题。实际操作中我建议跨线程传数据时使用值类型或隐式共享类型比如QByteArray、QVector 或者自定义结构体但保证它是值语义。不要在线程间直接传递裸指针因为你没法确定接收者处理这个指针时发送者是否已经释放了。4. 用QThread把耗时任务挪出主线程4.1 主线程卡死的本质在窗口程序里界面渲染和鼠标事件处理都发生在主线程也就是GUI线程。如果你在槽函数里做耗时操作比如打开一个几百兆的文件、跑一个大FFT整个事件循环就一直停在那个槽函数里界面上所有控件都不再响应窗口会变成未响应状态。这就是卡死的原因不是程序真死了是事件循环被占用。解决办法只有一个把耗时操作放到别的线程。但别急着把所有东西都丢进线程。比如打开一个文件对话框选文件这种操作本身是用户在交互不需要放线程。真正需要放线程的是文件读取、网络请求、图像处理、FFT计算这类可能耗时几百毫秒以上的任务。4.2 QThread的两种用法QThread的用法网上争论很多我直接说结论。第一种是继承QThread重写run()在run()里写循环或耗时逻辑。这种方式适合线程只做一件事而且不怎么做事件交互的场景比如一个后台心跳线程。第二种是创建一个普通QObject子类Worker用worker-moveToThread(thread)把Worker对象的亲和性移动到子线程里再用信号
做Qt开发这几年我经常在技术社区里看到一类提问qt弹出对话框选择文件、qt时域图转换为频域图,使用qcustomplot显示、qcoreapplication::exec() 之后就无法捕获了。这些问题单个看都不难但串起来就是一个Qt开发者最真实的成长路径从搭环境、做界面到读文件、开线程再到画波形、算频谱最后打包发布还得应付各种崩溃。这篇是Qt基础篇的第七篇我不打算按文档顺序讲而是用一个非常典型的上位机小工具把这些知识点串起来。小工具的功能很朴素点按钮选一个数据文件读完以后在界面上画出时域波形再点一下对这段数据做FFT把频谱图也画出来整个读取和计算过程放在后台线程界面不能卡死最后用发布工具打包能在一台没装Qt的电脑上直接跑。看完这篇你不仅能复现这个工具还能顺带搞清楚Qt的元对象系统、信号槽、事件循环、多线程、qcustomplot和kissfft集成以及发布和崩溃处理这些核心问题。1. 先看看大家都在搜什么1.1 高频搜索词背后的七个典型问题把热词表拉出来看Qt相关的提问其实高度集中。第一类是环境安装类包括qt下载、qt安装、qt creator安装、qt 5.15.2下载安装、卸载qt这类问题占了很大比例说明很多人在第一步就卡住了。第二类是工程配置类比如在vs code中如何规范qt项目、用vs打开qt的项目qt的文件都找不到这在跨平台开发和团队协作时特别常见。第三类是界面交互类比如qt弹出对话框选择文件、qt获取文件信息、qt好看的等待提示框。第四类是绘图与算法类比如qt时域图转换为频域图、使用qcustomplot显示、qchart实现图片缩放、qt绘制三维曲线。第五类是事件与线程类比如qt多线程、qt中的消息队列、qcoreapplication::exec() 之后就无法捕获了。第六类是发布与稳定性类比如qt发布软件、qt崩溃、qt中使用breakpad。第七类是扩展集成类比如qt怎么调用halcon、qt加载焊缝并选择提取焊缝、qt自动更新开发。这些搜索词叠在一起能看出一个很典型的心态大家学Qt基础不是想学孤立的概念而是想做出一个能用的东西。一个能把数据读进来、画成波形、算出频谱最后还能发给别人的桌面小工具几乎能覆盖上述大部分痛点。1.2 一个例子串起所有知识点所以我这篇干脆从一个信号采集与频谱显示小工具入手。这个工具对应的场景在工业上位机开发里很常见从某个数据文件或设备里拿到一串采样点先在时域看原始波形再做FFT看频域特征。你只需要掌握四件事Qt工程怎么建、qcustomplot怎么引入、QThread怎么把耗时计算放到后台、kissfft怎么接进来做频谱转换。在此基础上发布打包和崩溃捕获这两个进阶话题会一并处理因为它们才是让你从自己跑得动到别人也跑得动的关键台阶。2. 环境搭建从版本选择到交叉编译2.1 Qt版本与安装器选择Qt版本选择没有太多玄学如果你没有特殊需求直接用5.15.2这个LTS版本。它在开源用户里覆盖率最高网上能查到的问题和答案也最多。安装时不需要把整个套件全选Windows下通常只需要勾选MinGW 8.1.0 64-bit和MSVC 2019 64-bit中的其中一个。我个人做法是MinGW留一个、MSVC留一个MinGW发给学生和爱好者用很方便因为不需要装Visual StudioMSVC留在正式项目里用因为和VS的调试器、性能分析工具配合更好。安装器本身是联网下载网速不好的时候会非常考验耐心。如果下载卡住可以试试用清华或中科大的镜像把在线安装器的下载源指过去或者找验证过的离线安装包。另外安装目录绝对不要带中文和空格这是很多人踩过的第一个坑。后面编译第三方库或者做交叉编译时路径里有空格会引发一堆莫名其妙的问题排查起来非常浪费时间。2.2 三种编辑器工作流环境搭好之后下一步是选工作流。最省心的是Qt Creator它自带的qmake和CMake支持、调试器集成、UI Designer都很成熟。但有些人已经习惯了Visual Studio或VSCode这里分两种情况看。如果你用VS打开Qt项目发现qt的文件都找不到多数不是文件丢了而是打开方式错了。VS不认识.pro文件。如果项目是qmake体系需要先在Qt Creator或命令行里让qmake生成VS工程或者干脆用CMake重写工程然后用VS打开CMakeLists.txt。至于在vs code中如何规范qt项目核心是装好C插件和CMakeTools插件再用CMakePresets.json指定Qt的CMAKE_PREFIX_PATH。VSCode本身不负责编译它只负责编辑和定位错误构建还是要靠CMake。我的建议是个人学习用Qt Creator团队开发如果坚持VSCode就老老实实用CMake一条路走到黑。2.3 引入qcustomplotqcustomplot严格说不是一个库而是两个文件qcustomplot.h和qcustomplot.cpp。从官网拿到这两个文件后直接拖进工程即可。qmake工程把它们加进SOURCES和HEADERSCMake工程就加到target_sources里。很多新手以为qcustomplot需要编译成动态库其实完全没必要源码编译进你的程序里更省事。唯一的缺点是头文件比较大编辑器智能提示会稍慢一点。qcustomplot的API设计得很Qt风创建一个QCustomPlot控件放到界面上调用addGraph()添加曲线用graph(0)-setData(x, y)设置数据最后调replot()重绘。它底层提供了QCPGraph、QCPAxis这些类缩放、平移、鼠标取点都有现成接口。这也是为什么时域图转频域图这种需求在Qt社区里基本都会推荐qcustomplot而不是自己拿QPainter慢慢画。2.4 交叉编译到底在做什么交叉编译这个词对刚入门嵌入式Qt的人来说很劝退但拆开看并不复杂。开发板上的程序不是把源码复制过去现场编译而是在开发机上用一套交叉编译工具链把程序编译成目标架构能识别的二进制再把二进制和依赖的Qt库拷贝到开发板。Qt的交叉编译核心是qmake的spec文件比如ARM平台要指定arm-linux-gnueabihf-g再配合qtbase里预先配置好的交叉编译参数。这一步水深涉及sysroot、链接器路径、qmake.conf的修改。基础篇里只需要记住一个结论交叉编译的难点不是Qt本身而是目标平台工具链。你只要保证开发机上能编译出x86的Qt程序再拿到一个官方提供或社区验证过的交叉编译脚本按脚本走就能生成开发板可运行文件。真正容易出问题的不是代码而是库依赖不齐、Qt模块没编全、glibc版本冲突。前期调试尽量用开发板厂家提供的Qt库比自己从头编译整套Qt要省心得多。3. 元对象系统、信号槽与消息循环的底层逻辑3.1 没有moc就没有信号槽Qt和其他C框架最大的区别就是元对象系统。你在类里写Q_OBJECT宏Qt在编译前会多运行一个叫moc的程序对这个类做预处理生成一个moc_xxx.cpp文件。这个文件里包含类的元信息类名、父类、信号列表、槽列表、属性列表。运行时connect函数实际是通过这些元信息来匹配信号和槽的。所以你会发现如果某个类忘了加Q_OBJECT信号槽就会失灵而且编译报错非常奇怪比如未定义的引用 vtable。这就是因为moc没有给这个类生成元对象代码。我给大家一条纪律凡是自己写的QObject子类不管有没有自定义信号都老老实实加上Q_OBJECT。这一条能省掉大量排查时间。3.2 connect的三种写法connect函数在Qt5以后有很多种写法我建议分三阶段掌握。第一阶段用SIGNAL/SLOT宏connect(sender, SIGNAL(valueChanged(int)), receiver, SLOT(onValueChanged(int)));这种写法的优点是直观缺点是槽名写错了只有运行时报错编译期不拦你。第二阶段用函数指针connect(sender, SenderClass::valueChanged, this, ReceiverClass::onValueChanged);编译期就能检查参数是否匹配这是Qt5推荐写法。第三阶段用lambda适合处理短逻辑connect(sender, SenderClass::valueChanged, this, [](int value){ ui-label-setText(QString::number(value)); });但lambda默认捕获this时有一个风险如果接收者已经销毁lambda里再操作this就是悬空指针。稳妥的做法是在连接时使用上下文对象或者在lambda内先做有效性判断。很多信号槽没反应的问题都出在连接类型上。默认情况下同一个线程里的信号槽是直接调用跨线程是队列调用。直接调用就像普通函数调用发信号的一方会等槽函数执行完才返回队列调用则把槽函数放进接收者所在线程的事件循环里异步执行。如果接收者所在线程没有事件循环队列连接的槽函数就永远不会执行。这个知识点在下一部分会反复用到。3.3 exec()之后到底发生了什么很多人在程序里写这样的代码int ret app.exec(); // 下面的代码很少被执行到或者以为在exec()之后注册崩溃捕获就能捕获崩溃。实际上从exec()返回的那一刻Qt事件循环已经退出正常Qt程序生命周期到这里就结束了。崩溃往往不是发生在exec()之后而是发生在事件循环内部的某个事件处理过程中。崩溃信号由操作系统直接接管根本不经过你代码里的try/catch。所以breakpad这类崩溃捕获库的初始化一定要放在exec()之前而且崩溃处理函数里只能做最简单的事比如把崩溃上下文写到文件然后立即退出。exec()本身的作用是启动一个事件循环。事件循环可以理解为一个不停从事件队列里取事件、分发事件的循环。鼠标点击、键盘输入、定时器超时、跨线程信号队列连接这些都会变成事件挂到队列里。只要这个循环在跑程序就能持续响应外部操作。如果你在某个按钮的槽函数里写一个while(1)事件循环就被堵住了界面立刻假死。这也是为什么耗时的操作不能放在主线程的根本原因。3.4 消息队列与跨线程通信Qt里的消息队列和操作系统层面的消息队列不太一样它更多指QEvent加上QCoreApplication::postEvent()这套事件分发机制。signal/slot在跨线程时本质上就是往接收者所在线程的事件队列里post一个QMetaCallEvent。还有一个常见误解是所有跨线程都该用信号槽。不一定跨线程也可以用QMutex保护共享数据或者用QMetaObject::invokeMethod把方法调用切到目标线程。但信号槽是最Qt味的写法也最容易避免手动加锁带来的死锁问题。实际操作中我建议跨线程传数据时使用值类型或隐式共享类型比如QByteArray、QVector 或者自定义结构体但保证它是值语义。不要在线程间直接传递裸指针因为你没法确定接收者处理这个指针时发送者是否已经释放了。4. 用QThread把耗时任务挪出主线程4.1 主线程卡死的本质在窗口程序里界面渲染和鼠标事件处理都发生在主线程也就是GUI线程。如果你在槽函数里做耗时操作比如打开一个几百兆的文件、跑一个大FFT整个事件循环就一直停在那个槽函数里界面上所有控件都不再响应窗口会变成未响应状态。这就是卡死的原因不是程序真死了是事件循环被占用。解决办法只有一个把耗时操作放到别的线程。但别急着把所有东西都丢进线程。比如打开一个文件对话框选文件这种操作本身是用户在交互不需要放线程。真正需要放线程的是文件读取、网络请求、图像处理、FFT计算这类可能耗时几百毫秒以上的任务。4.2 QThread的两种用法QThread的用法网上争论很多我直接说结论。第一种是继承QThread重写run()在run()里写循环或耗时逻辑。这种方式适合线程只做一件事而且不怎么做事件交互的场景比如一个后台心跳线程。第二种是创建一个普通QObject子类Worker用worker-moveToThread(thread)把Worker对象的亲和性移动到子线程里再用信号
