★ FEATURED ARTICLE 1. 为什么在2025年还建议从Qt入手先想清楚再动手很多人第一次听到Qt读作 cute和cute可爱一个音是在某个招聘帖或者学长的工作汇报里。这个框架多年下来一直处于一种好像总在听、但又不太清楚它到底能干什么的状态。其实它就是一套用C编写的跨平台界面开发框架你可以把它理解成一套预制积木窗口、按钮、输入框、列表、菜单这些桌面软件里反复出现的东西Qt都提前做好并封装成了现成的类你要做的事情是把它组合起来而不是每次从零开始去调用系统底层的接口。用比较直白的话说Qt解决的是两个核心问题第一是写一次代码能在多个操作系统上运行Windows、macOS、Linux桌面环境都支持第二是界面和业务逻辑分离——你不需要手写一堆跟操作系统窗口打交道的地层代码Qt的信号与槽机制把按钮点击、数据变动这些事情和对应的处理函数自然地绑定起来写起来顺畅很多。我自己刚开始接触Qt时第一感受是它怎么比MFC舒服这么多。MFC那一套宏和消息映射有点绕而Qt通过元对象编译器moc处理信号与槽代码风格清晰很多。这些都是后话现阶段你只需要知道Qt在工业软件、设备上位机、安防监控客户端、教学演示工具这些领域仍然是主力之一学会它不是在做无用功。这一篇重点写环境搭建目标读者是两类人一是完全没接触过Qt、想试试水的新手二是以前用Qt 4或Qt 5、现在需要升级或换机器重新配置的老人。环境搭建这类事情网上教程不少但很多版本老旧、编译器套件对不上、路径带中文导致一堆疑难杂症。这篇文章会把从下载到敲出第一个可运行窗口的完整过程、背后的选型理由、以及常见坑位处理方式都讲清楚。1.1 先弄清Qt安装包是什么在线安装器与离线安装包的区别到官网下载页你会发现Qt提供两种下载方式一种是小体积的在线安装器好几年前开始默认引导用户走这条路另一种是完整离线安装包体积通常好几个GB需要登录。在线安装器好处是按需勾选组件下载量小以后要加装东西再打开它同步即可坏处是网络不稳定时容易中断国内直连速度可能不太理想。离线安装包则是把很多东西一次性拉下来占磁盘空间大但在内网环境、断网环境里方便很多。一个容易踩的坑是现在官方下载页面默认把在线安装器放在最显眼的位置离线安装包藏在页面底部Qt Archive入口里。新手常常下载完在线安装器之后不知道后续怎么操作或者找到离线包却发现需要注册账号登录。这里提前说明两种方式最终装出来的东西没有本质区别具体选哪种看你的网络条件和耐心。如果网络流量充裕、希望在安装阶段少折腾可以直接选离线包如果只是在虚拟机里为了学个基础语法在线安装器更轻。1.2 动手之前必须先决定的版本问题Qt 5还是Qt 6新手最容易困惑的就是版本选择。虽然Qt 6已经发布好几年但很多公司老项目还在用Qt 5.15 LTS教材和旧博客也大量基于Qt 5。我个人的建议是如果你是从零开始学装Qt 6当前主流的新版本如果你单位有明确的老项目要求才需要装Qt 5.15 LTS。原因很简单——Qt 6的API更现代对高分屏、触摸屏支持更好官方在线文档和示例也都是围绕Qt 6维护从Qt 6回过头去看Qt 5的代码绝大多数基础部分是兼容的以后真遇到老项目再补充对应知识也不迟。有一个细节值得注意Qt 5的最后一个长期支持版本是5.15但开源版本对5.15的更新维护已经结束商业版用户除外可以说继续停留在5.15的意义越来越小。而Qt 6系列里6.2和6.8都是LTS长期支持版本版本号看起来很杂但安装阶段不需要纠结安装器会列出来直接选最新的稳定LTS即可。1.3 许可证问题开源用户需要了解的一件事Qt有开源版和商业版两种授权开源版采用的是LGPLv3和GPLv3双授权。对绝大多数个人学习、非商业项目来说用开源版完全没问题商业闭源项目如果动态链接Qt在LGPL条款下通常也可以接受。这里不展开法律细节但有一个常识要记住你下载安装的是开源版这不代表你写的代码必须开源。区别在于你如果修改了Qt自身源码并分发出去才需要按相应许可证开放修改部分。环境搭建阶段看到安装器里跳出开源版选项就直接选它不会有什么隐患。2. 搭建开发环境的第一步下载、安装与组件选择2.1 下载前需要准备什么我建议你在下载安装之前先把下面几件事做了能省掉后面一大半的幺蛾子。首先确认操作系统是64位还是32位。现在绝大多数电脑都是64位但如果你还在用比较老的机器或者虚拟机镜像最好先看一眼。Qt安装器里会区分对应架构的组件选错的话后面编译程序时会提示找不到合适的编译器工具链跟原有的系统没关系纯粹是组件之间组合不匹配。其次给Qt一个干净的安装位置。Windows上常见的错误是安装在带有空格的路径里比如C:\Program Files\Qt。虽然Qt如今对路径中空格的兼容性比早期好了不少但某些第三方工具、构建脚本对空格依然敏感尤其当你以后要交叉编译嵌入式版本时特定工具链遇到空格路径很容易出莫名其妙的问题。我的习惯是装在D盘或者C盘根目录下一个简短无空格的路径比如C:\Qt或D:\QtWorkspace后面做任何配置都省心。最后确保磁盘空间足够。只装Qt框架本身可能还好大概3到5个GB但如果你同时勾选了多个编译器套件和Qt源码包轻轻松松就20GB以上。新手前期不需要全部组件按需勾选即可但预留10GB空间是比较稳妥的做法。2.2 安装过程中的关键步骤选择自定义安装而不是快速安装安装器默认会推荐快速安装但我不建议新手直接点快速安装原因是快速安装会安装一堆你暂时用不到的组件而且可能自动选择了跟演示不完全一致的版本组合。选择Custom Installation自定义安装你可以清楚看到自己到底往机器里装了些什么。进入选择组件页面后你会看到一大堆条目有些名字带LTS字样有些是Latest Release还有Additional Libraries、开发者工具等子项。真正需要注意的不是全部看懂而是掌握两个关键点第一Qt版本本体的勾选这是核心第二对应这个版本的编译器套件需要和本体一起勾上。比较常见的做法是勾选最新的长期支持版比如Qt 6.5/6.8然后展开它看到里面还有细分的小组件比如Qt 5 Compatibility ModuleQt 5兼容模块、Additional Libraries里可以选择Qt WebEngine、Qt Charts、Qt Data Visualization等扩展模块。前期学习阶段只需要基础模块加上一个兼容模块就够了其他比如Qt WebEngine以后用到再回来补装也完全可以。这个在线安装器的好处是随时可以重新打开增量添加组件不用为了一个扩展模块把整个框架重装一遍。安装器的另一个关键页面是工具链和构建工具的选择。Windows上Qt官方文档推荐的编译器套件一般分成两类一类是MinGWGCC在Windows下的实现另一类是MSVCMicrosoft Visual C编译器。这几乎是每个新手都会在第一周遇到的问题我单独在下一小节展开讲。2.3 选择编译器套件MinGW还是MSVC我怎么选这可能是搭建Qt环境过程中第一个值得认真想清楚的问题。Qt本身是一个跨平台框架但它也要依赖具体的编译器把C源代码变成可执行文件。Windows下主要有两条路MinGW套件官方在安装包里直接绑了对应版本的GCC工具链整体是自包含的不需要额外安装Visual Studio。选择这个套件你在Qt Creator里写完代码直接点构建就能跑对新手最友好。MSVC套件只提供Qt面向MSVC的库文件编译器本身需要单独安装Visual Studio Build Tools或者是完整的Visual Studio。好处是MSVC相关的调试器、性能分析工具和Windows SDK集成度更好企业里很多项目也是MSVC路线的。你可能会问既然MinGW这么省事为什么不是所有人都用MinGW原因是如果你的项目里日后需要依赖某些只有MSVC版本二进制库的第三方模块就会出现编译环境不一致问题。反过来如果用MSVC套件你项目里想使用MinGW编译的第三方库同样也是各种报警告。对基础学习阶段我强烈推荐直接选MinGW套件。毕竟你现在的目标是先跑起来、看到窗口、理解信号与槽而不是第一时间纠结别人给你传的.lib文件与当前编译器是否匹配。选择MinGW还会顺带牵扯到一个细微问题MinGW的位数版本。64位系统推荐选64位版的MinGW套件比如Qt 6.8.0 MinGW 11.2.0 64-bit。32位版在内存使用上有一些设计限制现在的开发机没必要再反向兼容它。选中对应条目之后继续往下走安装器会询问是否安装Qt Creator这个IDE默认会勾选留着即可。2.4 安装完成后第一次打开Qt Creator需要做的事安装完成之后桌面上会出现Qt Creator图标。第一次打开时它会让你选择主题、配置快捷键风格跟其他流行IDE的键位类似不用太精细先走默认就行。比较关键的是进入界面后确认工具菜单里的Kits套件列表中已经自动检测到了刚才安装的编译器。正常情况下你在安装器里选了什么编译器Qt Creator会自动关联好。但不排除某些情况下检测失败这时候点开工具-选项-Kits手动添加一个Manual Kit把编译器路径指到安装目录的对应bin文件。MinGW的编译器可执行文件名字通常是mingw32-make.exe旁边的g.exe或者gcc.exe看到它们说明工具链本身是完好的。如果此时你发现Kits里显示的Qt版本和编译器旁边有黄色警告图标不要急着继续下一步先点开Qt Versions标签页确认qmake路径是否正确。qmake是Qt的构建工具之一路径应在安装目录的对应版本子目录里例如C:\Qt\6.8.0\mingw_64\bin\qmake.exe。只要这一步路径对上Kits自动就会变成正常状态。3. 第一个Qt程序如何确认环境真正可用环境装好了接下来最自然的问题是怎么验证这套环境真的可以工作答案很简单创建一个Hello World级别的GUI程序编译运行看到一个窗口弹出来。3.1 新建项目的完整流程打开Qt Creator在最左侧点新建项目弹出的向导里有不少模板。有些教程让你选Qt Widgets Application有的让你选Qt Console Application。界面上带按钮的桌面程序通常选Qt Widgets Application这个模板自动帮你生成一个带主窗口类的最小工程适合第一眼看到图形界面效果。接着要设置项目名称和保存路径。这里有两个不能忽略的细节项目名称不要用中文保存路径也不要包含中文或空格。Qt的构建系统在绝大多数情况下能处理中文路径但一旦遇到某些第三方模块中文路径大概率会翻车。这种玄学问题排查起来很浪费时间直接从一开始用英文路径最省事。下一步会要求选择构建套件Kit把之前确认过的MinGW套件勾上即可。随后还会有一次确认类的页面保持默认点击完成。随后Qt Creator会自动生成一组文件包括一个.pro后缀的项目文件、main.cpp入口文件、mainwindow.cpp/mainwindow.h主窗口实现文件、以及一个界面描述文件。3.2 关键文件到底在干什么.pro、main.cpp与mainwindow类看到这里有些新手可能开始有点慌觉得项目一下子生成了一堆文件。不要慌这些文件各有明确分工。首先是.pro文件Qt 6中如果用CMake则是CMakeLists.txt新版向导可能默认选CMake。.pro文件描述项目的配置比如项目依赖哪些Qt模块widgets、gui等、源文件有哪些、生成程序的名称是什么。你可以在里面看到这样两行QT core gui greaterThan(QT_MAJOR_VERSION, 4): QT widgets第一行的作用是让链接器去连接Qt核心模块和图形模块第二行则是针对Qt 5/6所必需的因为Qt把界面控件相关模块从Gui模块分离到Widgets模块里了这是一次历史版本变更。新手如果不小心把这一行删了编译时会报一堆QMainWindow未定义之类的链接错误所以知道这两行的意义很重要。然后是main.cpp它是程序入口。默认生成的代码大概是#include mainwindow.h #include QApplication int main(int argc, char *argv[]) { QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); }这里的逻辑可以这样理解QApplication是Qt应用程序对象负责管理事件循环MainWindow w是你自己定义的主窗口类对象w.show()让窗口显示a.exec()让程序进入事件循环等待用户交互和窗口消息。基础阶段你不需要改这段代码重点理解它是怎么串起来的。mainwindow.h和mainwindow.cpp则定义了主窗口类目前只包含基本的构造函数和析构函数编译后能看到一个几乎空白的窗口。如果这一步能跑通说明你的环境没什么大问题。3.3 编译运行与常见输出分析在Qt Creator左下角选择构建套件后直接点击绿色的运行按钮。第一次编译需要一点时间因为要生成Makefile和中间文件下方编译输出窗口会打印信息。如果一切正常最终会出现一行类似连接成功的提示随后弹出一个空白窗口。这个窗口可能不醒目但它意义重大——它表明你从下载到编译部署的整条链路是通的。此时可以在窗口标题栏上看到程序名你可以在mainwindow.cpp的构造函数里加一行setWindowTitle(我的第一个Qt程序);再运行一次窗口标题就会变成你设置的内容。这是第一个真正由你动手修改代码并看到变化的瞬间建议体会一下这个流程改代码、编译、看效果。整个Qt开发最基础的循环就是这个。如果编译过程中出现红色错误最常见的是两种情况第一种是Kits里没有可用的编译器或者qmake不存在这需要回到工具菜单检查套件配置第二种是编码错误或路径错误下面第四大章会给你一套完整的排查思路。这里先教你一个最基础但很实用的动作看编译输出窗口里面Error后面的第一行描述它通常直接指向了出错的文件和行号不要紧闭双眼去猜先看它说什么。4. 新手最容易踩的坑我实测过的典型问题与排查思路4.1 编译报cannot find -lQt5Widgets这类链接错误的根因与处理无论你用的是Qt 5还是Qt 6链接错误基本都长一个样报“cannot find -lQt5Widgets”或“cannot find -lQt6Widgets”不等。新手第一反应是去网上搜Qt6Widgets是什么而实际上这个错误的核心是链接器在库搜索路径里找不到Qt的Widgets模块。为什么会找不到通常是因为编译器套件和Qt的模块版本对不上。比如你用的是MSVC编译器但安装器只装了MinGW版本的Qt库或者你编译器是否选中了与Qt库一致的架构比如一个64位编译器尝试链接32位的库这也行不通。解决思路按顺序排查先打开构建菜单里的清理项目然后重新构建项目排除缓存类问题接着点开工具-选项-Kits看当前使用的套件里Qt Version那一栏是不是正确指向了可用的qmake再看编译器那一栏的“C编译器”是否被识别。还有一种很容易遗漏的原因系统环境变量PATH里可能还存在旧版的Qt路径导致Qt Creator选择编译器时出现了混乱。在Windows上打开系统属性-环境变量把旧的Qt相关路径清理掉保留当前安装目录即可。4.2 中文乱码问题的两个层面源码编码与界面显示国内开发者几乎都会在面对Qt时遇到中文乱码。乱码一般分两层一层是源码里的字符串显示乱码另一层是程序运行后窗口上的中文标题或按钮文字显示乱码。微软的MSVC编译器默认把源代码文件按本地代码页通常是GBK来解释而Qt Creator默认把源码保存为UTF-8这两个不一致就会导致源码里的中文字符串在编译后被当成乱码数据。Qt 5较早的版本还会进一步踩到Qt对本地编码处理的坑。针对这个问题的标准解法有几种第一种是在源码开头加上sQt编码探测指令类似的编译指令#if defined(_MSC_VER) #pragma execution_character_set(utf-8) #endif这样MSVC会把可执行文件内的字符串编码统一为UTF-8效果比较干净。第二种做法是强制要求Qt Creator把文件保存为“UTF-8 without BOM”并在工具-选项-文本编辑器里设置默认编码。如果你用的是MinGW套件而不是MSVC通常不存在这个乱码问题因为GCC对UTF-8源码的处理更符合现代习惯。至于界面运行时显示的乱码往往是因为程序运行时字体不支持中文字形或者代码里指定了一个不支持中文的字体。空窗口默认使用系统字体一般不会有事只有当手动设置字体为某些西文字体时才会看到中文变成方框。遇到方框换回系统字体或者指定为“Microsoft YaHei”这类中文字体即可。4.3 构建的到底是哪个qmake环境变量引发的灵异事件有一类问题表现得特别诡异你的Qt版本明明安装好了Kits配置里也指向了对但每次构建时提示“无法识别的编译器”或指定的套件无效。这种问题里有一部分是环境变量和缓存路径互相打架。调试步骤我建议这样来在项目构建设置里把Shadow Build目录构建的中间文件夹路径改成项目目录下的build文件夹避免构建目录过深、路径过长接着检查环境变量PATH中是否有多个Qt安装目录。如果一台电脑之前装过旧版Qt又卸载不干净PATH里残留的旧路径会让qt.conf配置文件优先加载到旧版插件目录常见表现是“构建成功但运行时崩溃”或者加载不到平台插件。排查方法是用Qt自带的命令行工具。安装时会生成一个Qt 6.8 (MinGW 11.2.0 64-bit)这样的快捷方式点开它打开命令行窗口输入qmake -v和qmake -query QT_INSTALL_PREFIX看看输出路径是否指向当前安装版本。如果输出的路径不是预期路径说明PATH里前一个qmake把真正的路径挡住了。在环境变量设置里把用户变量PATH中的Qt目录移动到最前面或者干脆删掉旧的问题就能解决。4.4 示例程序能编但一运行就闪退一个完整的排查链路这里我分享一个真实出现过的场景也是模拟项目X开发时遇到过的程序编译顺利双击exe运行窗口闪一下就消失。错误窗口提示“程序异常结束”或“This application failed to start because no Qt platform plugin could be initialized”。这个错误其实非常有名核心原因是程序在运行时要加载Qt的平台插件在Windows上就是qwindows.dll但这个插件缺失或者加载失败。为什么会这样最常见的是Release构建复制程序时只拷了exe文件没有带上Qt的动态链接库。Qt程序不像一个纯C语言生成的单文件exe它运行需要一系列dll和插件目录。解决方法是用Qt安装目录下自带的部署工具例如windeployqt.exe在命令行里对生成的exe执行一次它会自动把需要的几个dll和plugins复制到exe同目录下windeployqt your_application.exe第二个常见原因是平台插件路径有问题。比如你手动设置了环境变量QT_QPA_PLATFORM_PLUGIN_PATH指向了错误的目录程序在启动时就无法找到平台插件。解决办法是把该环境变量清空或者直接让程序自己从main函数里的路径推导插件目录。对初学者来说最稳妥的做法是永远通过Qt Creator的“运行”按钮来启动程序因为Qt Creator会在运行时把相关的动态库路径通过PATH传递进去。只有当你要把程序发给别人、移植到它处运行时才需要动用windeployqt部署这一步。5. 环境搭好之后推荐的学习路径与验证方法5.1 从控件到绘图再到多线程的递进路线环境搭好、第一个窗口能跑起来很多人刚松一口气接着就陷入不知道接下来学什么的状态。我的建议是一条递进路线先熟练掌握常用控件及其信号槽用法再学习布局管理然后是自定义绘制与文件读写更进阶一步才是多线程、网络和数据库。这个顺序对应着从会用别人做好的控件到能按需求绘制自己的界面元素再到处理复杂业务逻辑的能力跃升。拿控件这块来说从QPushButton按钮、QLineEdit输入框、QLabel标签、QListWidget列表入手是很好的起点。每个控件把属性面板和信号槽搞清楚理解什么叫点击按钮时触发一个函数以及这个函数是怎么通过信号与槽连接到按钮上的。等你对这套机制有了肌肉记忆再看其他控件就很快了。5.2 善用官方示例代码但别直接复制粘贴Qt Creator的欢迎页面里自带大量示例项目路径通常在安装目录的Examples子目录里。在帮助菜单里输入关键词就能搜索到对应的示例代码。学习这些示例时我建议先完整浏览一遍main函数和主要类的构造函数搞清楚程序从哪开始执行、每个窗口部件在哪创建然后把工程复制一份做小改动——比如改变按钮的文字、增加一个文本框、添加一个信号槽连接。这种从完整代码出发做细小的改动的学习方式比自己从零硬写要快很多。但这里有个关键提醒示例代码大多是演示某种特性的最简实现距离生产级代码还很远。千万别养成从示例里复制粘贴然后拼起来用的习惯不然到后面一段代码里同时混着Qt 5旧式语法和Qt 6新式语法看着像会跑但让你从头解释逻辑就卡壳了。更好的习惯是动手前先在注释里写清楚自己想要什么再把示例代码当作查API的参考。5.3 如何验证自己真的学会了搭建环境这件事判断你熟练掌握了环境搭建标准不是能运行别人给的Demo而是你能做到下面三件事在没有原安装器的情况下仅凭安装目录和windeployqt把一个Qt程序部署到另一台干净的Windows电脑上让它跑起来遇到无法启动此程序因为计算机丢失Qt6Core.dll这类问题时能快速想到是部署不完整而不是程序写错了最后你能向同事清楚解释为什么Qt项目里要有Qt Widgets模块、为什么用MinGW和MSVC跑不同库会导致链接错误。如果这些点你都能说清楚那么不管Qt今后版本怎么升级、工具链怎么调整你都能以不变应万变。毕竟环境搭建这件事的本质是要建立一套代码编译成二进制、运行时能找到依赖的心智模型Qt只是承载这套模型的载体而已。就个人经验来说搭建Qt环境是学习过程中投入产出比极高的半小时——它的干扰项多但解决一个就多懂一个原理。几乎每个Qt老手都有一段在环境搞不定和放弃Qt之间反复横跳的历史但只要你不急着在第一天就写出炫酷的界面、能静下心来处理一个又一个报错后面学Qt会越来越顺。回到最初的问题为什么是Qt因为它把界面的积木已经给你备好了你只需要把地基打牢。
阅读完成 · 觉得有帮助？
