接到QT-环境安装及demo测试这个任务时我第一反应是这不就是大多数开发者踩坑最多的入门第一关吗网上教程虽然多但往往要么只讲下一步下一步要么一上来就甩一堆概念根本没提编译器匹配、组件选择这些真正卡脖子的地方。这次我把自己实际装过多次、也帮别人排过多个坑的完整流程整理一遍从环境选型、安装实操到第一个demo跑起来再到常见报错的排查方法一次讲透。1. 环境安装的整体思路与方案选型1.1 安装前先想清楚的三件事动手下载安装包之前先花五分钟回答三个问题能省掉后面至少两小时的折腾。第一你拿Qt做什么如果只是做传统桌面程序选Widgets模块就够界面简单直接想做触屏、动态效果更强的界面则要重点照顾QML相关模块做嵌入式或工控场景则要考虑交叉编译工具链。不同用途组件勾选和编译器选择差别很大。第二你在哪个系统上干活Qt虽然跨平台但Windows、Linux、macOS的安装方式和依赖差异不小后面我会分开讲。第三你的编译器是什么这一点在Windows上尤其关键MinGW和MSVC两套工具链编译出来的程序互不通用选错了Qt套件项目根本跑不起来。很多新手卡在代码没问题但构建失败八成就是这里出了问题。想清楚这三点再往下走就顺了。不用纠结最完美的配置记住一个原则能用、够用、顺手维护就是好环境。1.2 三种安装方式怎么选Qt的安装方式大体有三种官方在线安装器、离线安装包、系统包管理器Linux。我做了个对比表方便你根据自己的情况选。安装方式优点缺点适合场景在线安装器组件按需勾选、后续可增减下载依赖网络国内可能慢大多数开发机、需要版本灵活切换离线安装包一次性下载、离线安装体积大数GB、版本固定内网环境、网速不稳定、需要保留可靠安装介质包管理器apt等命令一行搞定、系统集成好版本偏旧、组件不完整Linux快速体验、CI环境、轻量测试在线安装器是最常用的方式它的核心优势是可控——你自己决定装哪个Qt版本、哪些模块、哪套工具链。缺点是官方服务器在国外网络不好时下载速度让人着急解决办法是换用国内开源镜像站的安装包或加速源装起来会舒服很多。离线安装包适合需要在多台机器上反复安装的情况它本质上是把一个完整版本打包好解压或运行即可缺点是体积随版本膨胀动辄五六个GB更新时还得重新下载新版离线包。包管理器则是Linux用户偷懒的选择一条命令装完Qt Creator、qmake、基础模块都给你备好但版本往往落后一两个迭代自己玩或跑小demo完全够用。我先说一个关键结论不管选哪种方式安装之前都要记住两点——安装目录不要带中文和空格工具链和Qt版本要尽量匹配别混搭。下面进入正题。2. Windows环境下的安装实操2.1 下载、账号与安装器启动在Windows上最稳妥的路径是用官方在线安装器。下载exe后直接双击第一步是登录Qt账号没有就现场注册一个需要邮箱验证。这一步别嫌麻烦以前的老版本允许跳过登录直接装后来改成了必须登录没有账号后续维护组件也用不了。这里有个小技巧打开安装器之后它会先让你选择组件目录这个目录我建议不要放在C盘默认位置因为整套工具链加模块装完普遍20GB朝上占用系统盘空间不说重装系统还得全部重来。我一般习惯把Qt放在D盘独立目录比如D:\Qt后续需要卸载、升级或者换版本整个文件夹删掉重来也不心疼。授权协议和组件选择界面是接下来最要紧的步骤。建议安装器里默认的Latest Releases视图下按需勾选对应版本的组件不要无脑全选。全选虽然省事但会拉长下载时间还可能误装一些你根本用不上的调试源码。记住安装器只是一个分发器装错组件后续在维护模式里还能改不用怕选错。2.2 组件勾选与编译器匹配组件勾选是Windows上最容易出问题的环节。以Qt 6.x为例展开版本号节点你会看到下面分类很细MinGW 64-bit这是编译器和Qt库一起提供的分组适合不装大体积IDE、想走命令行的场景MSVC 2019/2022 64-bit需要使用Visual Studio工具链时的选择Qt Creator和Qt Debugger ToolsIDE和调试器建议必选Additional Libraries里面是Image Formats、WebEngine等扩展模块按项目需要勾选先想清楚自己用MinGW还是MSVC这直接决定你后面的开发工具链。如果电脑上没装Visual Studio或者不想被动辄几个GB的VS吓到老老实实选MinGW那一项就行安装器会把适配好的编译器一并装上IDE配置也不用你操心。如果你平时就用VS写C那就选对应版本的MSVC分组然后在Visual Studio里装好Qt Visual Studio Tools插件来做集成体验也很好。最怕的情况是MinGW的Qt库配了MSVC的编译器或者反过来这种组合构建时全是莫名其妙的地层错误。勾完组件点Next进入协议确认安装器开始下载。网络好的话20分钟能完事儿网络不理想就换镜像源。装完之后打开Qt Creator在Tools菜单的Options里找到Kits你会看到系统已经自动识别好了一组可用的套件也就是Kit。正常情况它会显示Qt版本、编译器、调试器齐全没有黄色感叹号。如果有黄色的警告三角多半是编译器或调试器没识别上后面排查部分我会专门讲。3. Linux环境下的安装实操3.1 桌面系包的快速安装以Ubuntu/Debian为例Linux上最省事的方案是直接用系统包管理器。以Ubuntu为例打开终端依次执行sudo apt update sudo apt install build-essential sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools sudo apt install qtcreatorbuild-essential是编译C程序的基础套件提供gcc、g和make。qtbase5-dev是Qt 5的核心开发库和头文件qtchooser是qmake版本切换工具qtbase5-dev-tools里面带着uic、moc这些辅助工具缺了它们编译Qt程序会报找不到头文件之类的错误。最后qtcreator就是IDE本体。装完之后在终端里验证一下qmake --version g --version如果都能输出版本号说明基础工具链已经就位。用这种方法装出来的Qt是仓库自带的版本比如Ubuntu 20.04上通常是5.12.8。版本老一点但好处是也省心——系统包管理器会帮你处理好所有依赖比如OpenGL库、X11库这些不用像手动安装那样自己去补。在Ubuntu上跑Qt程序还要确认一件事OpenGL相关库是否正确安装。Qt的Widgets渲染在部分环境会依赖OpenGL如果运行demo时报GLX或libGL错误就再补装一下sudo apt install libgl1-mesa-dev libglu1-mesa-dev这个坑在虚拟机和老显卡驱动的机器上尤其常见装完包后基础demo跑不起来很多人误以为是Qt本身坏了其实是底层图形库缺失。3.2 手动安装版本自定义的代价如果嫌系统包版本太老或者想装Qt 6的新特性那就走手动路线。去官方下载页下载Linux平台的在线安装器注意文件名一般是qt-online-installer-linux-x64-xxx.run下载后用命令赋执行权限chmod x qt-online-installer-linux-x64-xxx.run ./qt-online-installer-linux-x64-xxx.run安装界面其实和Windows版差不多不过有两点要留神。第一安装到系统目录如/opt/Qt时很可能遇到权限不够的问题我习惯在家目录下安装比如/home/你的用户名/Qt这样就不用折腾sudo。如果一定要装/opt记得用sudo执行安装器否则写入失败会在安装中段报错。第二安装完以后Qt Creator不一定能自动找到编译器路径需要手动配置。打开Qt Creator后依次进入Tools Options Kits Qt Versions点Add按钮选择Qt安装目录下bin里的qmake程序比如/home/xxx/Qt/6.5.0/gcc_64/bin/qmake。添加成功后再切到Kits标签确保编译器一般是系统自带的g和Qt版本都已关联。配好之后重新打开一个项目选择这个自定义Kit就能正常构建了。4. Demo测试从跑通到真正理解4.1 先用自带示例验证环境环境装完先别急着手写代码用Qt自带示例跑一遍这是检验环境是否正常的最高效方式。打开Qt Creator在欢迎界面搜索Examples或者在左侧栏直接切到示例页面搜索一个名字里带hello或addressbook的示例前者的代码最简拿来测试最好。选中示例后可以直接打开项目选择你刚才配好的Kit点击运行。Qt Creator会自动执行qmake和make或cmake把示例编译并启动窗口。看到窗口弹出来、界面正常显示、按钮点击有反应就说明从编译器、Qt库到IDE整条链路都是通的。这里我要强调一个习惯用自带示例跑环境不要一上来就写自己的代码。原因很简单示例项目配置文件是官方维护好的能排除是不是我项目配置写错了这个变量。如果示例都跑不起来先回上一章排查编译器或库的问题如果示例跑得起来但你自己的项目不行问题大概率出在项目配置而不是环境本身。4.2 手写一个最小Demo从零新建到运行验证完自带示例接下来自己新建一个项目走完整个流程。这是我觉得必须手把手讲一遍的部分因为很多人只会打开别人的工程却连项目从无到有的几个关键选项都不知道是干什么的。第一步在欢迎页面点New Project选择Application分类下的Qt Widgets Application。这个模板会生成带界面文件.ui和主窗口类MainWindow的标准桌面程序骨架。第二步设置项目名称和保存路径建议用纯英文路径不要带中文否则部分编译器和调试器会抽风。第三步选择构建套件Kit这里选中你前面配好的那个Kit。第四步模板会生成几个文件main.cpp、mainwindow.cpp、mainwindow.h、mainwindow.ui。在左侧的Forms文件夹里双击mainwindow.ui进入可视化设计界面拖一个Label文本标签和一个PushButton按钮到窗口上。然后在mainwindow.cpp的构造函数里加一行代码ui-label-setText(Hello Qt, I am running!);点左侧的绿色箭头运行。如果一切正常窗口弹出标签显示你设置的那行文字。到这一步你已经完成了一次完整的Qt程序从设计到运行的全过程。这里有三个必须弄懂的小点我在新手期曾一遍遍踩ui-label是什么ui是mainwindow.ui编译后生成的C对象label是你在界面编辑器里给控件起的对象名。类的头文件里通常有一个namespace Ui的声明正是负责把.ui文件和C代码连接起来。修改.ui后为什么经常推荐重新构建因为.ui文件要经过uic工具转成头文件偶尔增量构建不灵光运行看到的还是旧界面手动Clean再Rebuild就好。中文乱码别慌Qt 5和Qt 6默认源码编码是UTF-8Linux下没问题Windows上如果出现中文乱码多数是编译器和源码编码不一致把源码文件另存为UTF-8带BOM或者使用QString::fromLocal8Bit临时过渡。4.3 脱离IDE的命令行编译测试跑通IDE流程之后我强烈建议你试一次用命令行编译Qt程序。因为实际工作中脚本自动化构建、无GUI的服务器环境、CI流程都需要你理解没有Qt Creator时项目是怎么编译的。这里用一个空白控制台程序来做示范。先建一个目录里面放一个main.cpp#include QCoreApplication #include QDebug int main(int argc, char *argv[]) { QCoreApplication app(argc, argv); qDebug() Qt environment works!; return 0; }在项目目录下用CMake方式构建mkdir build cd build cmake .. make不过这里的前提是你有一个CMakeLists.txt。最简单的CMakeLists.txt长这样cmake_minimum_required(VERSION 3.16) project(qtdemo) find_package(Qt5 COMPONENTS Core REQUIRED) add_executable(qtdemo main.cpp) target_link_libraries(qtdemo Qt5::Core)如果你用的是Linux系统包安装find_package会自动找到Qt的路径如果是手动安装cmake有时找不到Qt位置可以手动指定CMAKE_PREFIX_PATHcmake -DCMAKE_PREFIX_PATH/home/xxx/Qt/6.5.0/gcc_64 ..cmake配置成功后make生成了可执行文件运行它输出Qt environment works!说明忽略IDE也完全可以掌控构建过程。这一步做完你对程序到底是怎么被编译出来的理解会上一个台阶后续遇到脚本构建、交叉编译、部署打包都不至于心里没底。5. 常见问题与排查技巧实录环境安装和demo测试中踩过的坑我整理了一份排查速查表很多问题看起来五花八门根因就那么几个。现象常见原因解决办法Kit页签显示黄色感叹号没有编译器安装时未勾选对应编译组件用安装器的维护模式补装MinGW/MSVC组件报错qmake: not found环境变量PATH未配置手动安装时把Qt的bin目录加入PATH或放一个软链无法打开包含头文件QApplication.h not foundQt库未安装或cmake找不到路径确认qtbase5-dev安装手动指定CMAKE_PREFIX_PATH示例程序运行崩溃报GLX/XCB错误图形库缺失安装libgl1-mesa-dev和libxcb相关库Windows上运行exe提示缺少Qt DLL未部署Qt运行库用windeployqt工具自动拷贝依赖签字验证qt5.15.2 unknownqmake路径不对或版本冲突在Kits里移除错误qmake重新添加正确路径中文界面乱码源码编码与编译器不一致源码存为UTF-8带BOM或转义字符串代码能编译但运行就退出debug和release库混用确保配置里Debug/Release对应的Qt库一致前面几项比较常见这里多说几个带有操作细节的技巧。第一个Qt Creator里某些组件没法自动安装。你需要打开安装器主程序以维护模式运行选择添加或移除组件把缺失的编译器分组补上。不少人不知道安装器还能再被运行一次重新卸载重装其实是没必要的。第二个windeployqt的用法。在Windows下把生成的exe单独拷贝到一个空目录然后在终端里运行windeployqt 你的程序名.exe它会自动扫描exe依赖的Qt DLL、插件、翻译文件并全部拷贝到同目录。这是发布demo给同事看之前必做的一步。不过我测试时也踩过坑如果用了MinGW编译器windeployqt本身也要用同一套MinGW环境的命令行去跑否则它可能识别不了依赖。更省心的方法是让Qt Creator在构建完成后直接调用部署工具在Projects Build Settings里加自定义步骤适合长期项目。第三个关于MSVC调试器。很多用MSVC套件的人会发现项目能编译但调试按钮是灰的这是因为缺少Windows调试工具cdb。可以在Visual Studio Installer里添加Windows SDK或者单独安装对应版本的调试工具。如果只是跑demo不调试也无伤大雅但一旦开始严肃项目这个必须补上。最后再提示一个非常隐蔽的问题同时装了多个Qt版本和编译器时Windows上常见的报错是Failed to load platform plugin xcbLinux上或者platform windowsWindows上很多人以为是编译选项错了其实是环境变量或插件目录在捣乱。确认程序运行时能通过Qt的插件目录找到对应的platforms文件夹必要时在代码里设置插件搜索路径或者干脆把Qt的bin目录放进PATH。6. 环境维护与后续扩展建议装好环境、跑通demo只是Qt之路的起点。根据我个人反复安装维护的经验还有几个值得提前布局的小建议。一是掌握维护模式这个绝活。Qt安装器既是安装入口也是组件管理器。以后想补装一个模块比如WebEngine、Charts不用卸载重装打开安装器进入维护模式勾选新模块就行。这个操作很多人不知道导致换模块就跟重装系统似的。二是做好备份。我习惯把下载好的离线安装包或安装器程序单独归档到一块移动硬盘里因为官网下载页面改动频繁下次想找回特定小版本可能已经下架了。三是了解Qt版本差异。我曾经在5.15上写的项目直接换到Qt 6后遇到不少API变更比如QRegExp换成了QRegularExpression、High-DPI默认开启等如果项目要长期维护尽量早点定一个大版本方向。最后再说一个写代码之外的点Qt的构建产物路径尽量统一管理。Windows和Linux的库搜索路径、插件路径、资源编译规则都不一样首次配置一个好用且规范的CMake模板后面会省心很多。学习期间遇到报错不用慌我在上面表格里列的那些都是最常见的类型对照着排查大部分十分钟内就能解决。等到你亲手把一个窗口程序从头到尾跑起来的那个瞬间环境安装这关就算真正过了。
接到QT-环境安装及demo测试这个任务时我第一反应是这不就是大多数开发者踩坑最多的入门第一关吗网上教程虽然多但往往要么只讲下一步下一步要么一上来就甩一堆概念根本没提编译器匹配、组件选择这些真正卡脖子的地方。这次我把自己实际装过多次、也帮别人排过多个坑的完整流程整理一遍从环境选型、安装实操到第一个demo跑起来再到常见报错的排查方法一次讲透。1. 环境安装的整体思路与方案选型1.1 安装前先想清楚的三件事动手下载安装包之前先花五分钟回答三个问题能省掉后面至少两小时的折腾。第一你拿Qt做什么如果只是做传统桌面程序选Widgets模块就够界面简单直接想做触屏、动态效果更强的界面则要重点照顾QML相关模块做嵌入式或工控场景则要考虑交叉编译工具链。不同用途组件勾选和编译器选择差别很大。第二你在哪个系统上干活Qt虽然跨平台但Windows、Linux、macOS的安装方式和依赖差异不小后面我会分开讲。第三你的编译器是什么这一点在Windows上尤其关键MinGW和MSVC两套工具链编译出来的程序互不通用选错了Qt套件项目根本跑不起来。很多新手卡在代码没问题但构建失败八成就是这里出了问题。想清楚这三点再往下走就顺了。不用纠结最完美的配置记住一个原则能用、够用、顺手维护就是好环境。1.2 三种安装方式怎么选Qt的安装方式大体有三种官方在线安装器、离线安装包、系统包管理器Linux。我做了个对比表方便你根据自己的情况选。安装方式优点缺点适合场景在线安装器组件按需勾选、后续可增减下载依赖网络国内可能慢大多数开发机、需要版本灵活切换离线安装包一次性下载、离线安装体积大数GB、版本固定内网环境、网速不稳定、需要保留可靠安装介质包管理器apt等命令一行搞定、系统集成好版本偏旧、组件不完整Linux快速体验、CI环境、轻量测试在线安装器是最常用的方式它的核心优势是可控——你自己决定装哪个Qt版本、哪些模块、哪套工具链。缺点是官方服务器在国外网络不好时下载速度让人着急解决办法是换用国内开源镜像站的安装包或加速源装起来会舒服很多。离线安装包适合需要在多台机器上反复安装的情况它本质上是把一个完整版本打包好解压或运行即可缺点是体积随版本膨胀动辄五六个GB更新时还得重新下载新版离线包。包管理器则是Linux用户偷懒的选择一条命令装完Qt Creator、qmake、基础模块都给你备好但版本往往落后一两个迭代自己玩或跑小demo完全够用。我先说一个关键结论不管选哪种方式安装之前都要记住两点——安装目录不要带中文和空格工具链和Qt版本要尽量匹配别混搭。下面进入正题。2. Windows环境下的安装实操2.1 下载、账号与安装器启动在Windows上最稳妥的路径是用官方在线安装器。下载exe后直接双击第一步是登录Qt账号没有就现场注册一个需要邮箱验证。这一步别嫌麻烦以前的老版本允许跳过登录直接装后来改成了必须登录没有账号后续维护组件也用不了。这里有个小技巧打开安装器之后它会先让你选择组件目录这个目录我建议不要放在C盘默认位置因为整套工具链加模块装完普遍20GB朝上占用系统盘空间不说重装系统还得全部重来。我一般习惯把Qt放在D盘独立目录比如D:\Qt后续需要卸载、升级或者换版本整个文件夹删掉重来也不心疼。授权协议和组件选择界面是接下来最要紧的步骤。建议安装器里默认的Latest Releases视图下按需勾选对应版本的组件不要无脑全选。全选虽然省事但会拉长下载时间还可能误装一些你根本用不上的调试源码。记住安装器只是一个分发器装错组件后续在维护模式里还能改不用怕选错。2.2 组件勾选与编译器匹配组件勾选是Windows上最容易出问题的环节。以Qt 6.x为例展开版本号节点你会看到下面分类很细MinGW 64-bit这是编译器和Qt库一起提供的分组适合不装大体积IDE、想走命令行的场景MSVC 2019/2022 64-bit需要使用Visual Studio工具链时的选择Qt Creator和Qt Debugger ToolsIDE和调试器建议必选Additional Libraries里面是Image Formats、WebEngine等扩展模块按项目需要勾选先想清楚自己用MinGW还是MSVC这直接决定你后面的开发工具链。如果电脑上没装Visual Studio或者不想被动辄几个GB的VS吓到老老实实选MinGW那一项就行安装器会把适配好的编译器一并装上IDE配置也不用你操心。如果你平时就用VS写C那就选对应版本的MSVC分组然后在Visual Studio里装好Qt Visual Studio Tools插件来做集成体验也很好。最怕的情况是MinGW的Qt库配了MSVC的编译器或者反过来这种组合构建时全是莫名其妙的地层错误。勾完组件点Next进入协议确认安装器开始下载。网络好的话20分钟能完事儿网络不理想就换镜像源。装完之后打开Qt Creator在Tools菜单的Options里找到Kits你会看到系统已经自动识别好了一组可用的套件也就是Kit。正常情况它会显示Qt版本、编译器、调试器齐全没有黄色感叹号。如果有黄色的警告三角多半是编译器或调试器没识别上后面排查部分我会专门讲。3. Linux环境下的安装实操3.1 桌面系包的快速安装以Ubuntu/Debian为例Linux上最省事的方案是直接用系统包管理器。以Ubuntu为例打开终端依次执行sudo apt update sudo apt install build-essential sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools sudo apt install qtcreatorbuild-essential是编译C程序的基础套件提供gcc、g和make。qtbase5-dev是Qt 5的核心开发库和头文件qtchooser是qmake版本切换工具qtbase5-dev-tools里面带着uic、moc这些辅助工具缺了它们编译Qt程序会报找不到头文件之类的错误。最后qtcreator就是IDE本体。装完之后在终端里验证一下qmake --version g --version如果都能输出版本号说明基础工具链已经就位。用这种方法装出来的Qt是仓库自带的版本比如Ubuntu 20.04上通常是5.12.8。版本老一点但好处是也省心——系统包管理器会帮你处理好所有依赖比如OpenGL库、X11库这些不用像手动安装那样自己去补。在Ubuntu上跑Qt程序还要确认一件事OpenGL相关库是否正确安装。Qt的Widgets渲染在部分环境会依赖OpenGL如果运行demo时报GLX或libGL错误就再补装一下sudo apt install libgl1-mesa-dev libglu1-mesa-dev这个坑在虚拟机和老显卡驱动的机器上尤其常见装完包后基础demo跑不起来很多人误以为是Qt本身坏了其实是底层图形库缺失。3.2 手动安装版本自定义的代价如果嫌系统包版本太老或者想装Qt 6的新特性那就走手动路线。去官方下载页下载Linux平台的在线安装器注意文件名一般是qt-online-installer-linux-x64-xxx.run下载后用命令赋执行权限chmod x qt-online-installer-linux-x64-xxx.run ./qt-online-installer-linux-x64-xxx.run安装界面其实和Windows版差不多不过有两点要留神。第一安装到系统目录如/opt/Qt时很可能遇到权限不够的问题我习惯在家目录下安装比如/home/你的用户名/Qt这样就不用折腾sudo。如果一定要装/opt记得用sudo执行安装器否则写入失败会在安装中段报错。第二安装完以后Qt Creator不一定能自动找到编译器路径需要手动配置。打开Qt Creator后依次进入Tools Options Kits Qt Versions点Add按钮选择Qt安装目录下bin里的qmake程序比如/home/xxx/Qt/6.5.0/gcc_64/bin/qmake。添加成功后再切到Kits标签确保编译器一般是系统自带的g和Qt版本都已关联。配好之后重新打开一个项目选择这个自定义Kit就能正常构建了。4. Demo测试从跑通到真正理解4.1 先用自带示例验证环境环境装完先别急着手写代码用Qt自带示例跑一遍这是检验环境是否正常的最高效方式。打开Qt Creator在欢迎界面搜索Examples或者在左侧栏直接切到示例页面搜索一个名字里带hello或addressbook的示例前者的代码最简拿来测试最好。选中示例后可以直接打开项目选择你刚才配好的Kit点击运行。Qt Creator会自动执行qmake和make或cmake把示例编译并启动窗口。看到窗口弹出来、界面正常显示、按钮点击有反应就说明从编译器、Qt库到IDE整条链路都是通的。这里我要强调一个习惯用自带示例跑环境不要一上来就写自己的代码。原因很简单示例项目配置文件是官方维护好的能排除是不是我项目配置写错了这个变量。如果示例都跑不起来先回上一章排查编译器或库的问题如果示例跑得起来但你自己的项目不行问题大概率出在项目配置而不是环境本身。4.2 手写一个最小Demo从零新建到运行验证完自带示例接下来自己新建一个项目走完整个流程。这是我觉得必须手把手讲一遍的部分因为很多人只会打开别人的工程却连项目从无到有的几个关键选项都不知道是干什么的。第一步在欢迎页面点New Project选择Application分类下的Qt Widgets Application。这个模板会生成带界面文件.ui和主窗口类MainWindow的标准桌面程序骨架。第二步设置项目名称和保存路径建议用纯英文路径不要带中文否则部分编译器和调试器会抽风。第三步选择构建套件Kit这里选中你前面配好的那个Kit。第四步模板会生成几个文件main.cpp、mainwindow.cpp、mainwindow.h、mainwindow.ui。在左侧的Forms文件夹里双击mainwindow.ui进入可视化设计界面拖一个Label文本标签和一个PushButton按钮到窗口上。然后在mainwindow.cpp的构造函数里加一行代码ui-label-setText(Hello Qt, I am running!);点左侧的绿色箭头运行。如果一切正常窗口弹出标签显示你设置的那行文字。到这一步你已经完成了一次完整的Qt程序从设计到运行的全过程。这里有三个必须弄懂的小点我在新手期曾一遍遍踩ui-label是什么ui是mainwindow.ui编译后生成的C对象label是你在界面编辑器里给控件起的对象名。类的头文件里通常有一个namespace Ui的声明正是负责把.ui文件和C代码连接起来。修改.ui后为什么经常推荐重新构建因为.ui文件要经过uic工具转成头文件偶尔增量构建不灵光运行看到的还是旧界面手动Clean再Rebuild就好。中文乱码别慌Qt 5和Qt 6默认源码编码是UTF-8Linux下没问题Windows上如果出现中文乱码多数是编译器和源码编码不一致把源码文件另存为UTF-8带BOM或者使用QString::fromLocal8Bit临时过渡。4.3 脱离IDE的命令行编译测试跑通IDE流程之后我强烈建议你试一次用命令行编译Qt程序。因为实际工作中脚本自动化构建、无GUI的服务器环境、CI流程都需要你理解没有Qt Creator时项目是怎么编译的。这里用一个空白控制台程序来做示范。先建一个目录里面放一个main.cpp#include QCoreApplication #include QDebug int main(int argc, char *argv[]) { QCoreApplication app(argc, argv); qDebug() Qt environment works!; return 0; }在项目目录下用CMake方式构建mkdir build cd build cmake .. make不过这里的前提是你有一个CMakeLists.txt。最简单的CMakeLists.txt长这样cmake_minimum_required(VERSION 3.16) project(qtdemo) find_package(Qt5 COMPONENTS Core REQUIRED) add_executable(qtdemo main.cpp) target_link_libraries(qtdemo Qt5::Core)如果你用的是Linux系统包安装find_package会自动找到Qt的路径如果是手动安装cmake有时找不到Qt位置可以手动指定CMAKE_PREFIX_PATHcmake -DCMAKE_PREFIX_PATH/home/xxx/Qt/6.5.0/gcc_64 ..cmake配置成功后make生成了可执行文件运行它输出Qt environment works!说明忽略IDE也完全可以掌控构建过程。这一步做完你对程序到底是怎么被编译出来的理解会上一个台阶后续遇到脚本构建、交叉编译、部署打包都不至于心里没底。5. 常见问题与排查技巧实录环境安装和demo测试中踩过的坑我整理了一份排查速查表很多问题看起来五花八门根因就那么几个。现象常见原因解决办法Kit页签显示黄色感叹号没有编译器安装时未勾选对应编译组件用安装器的维护模式补装MinGW/MSVC组件报错qmake: not found环境变量PATH未配置手动安装时把Qt的bin目录加入PATH或放一个软链无法打开包含头文件QApplication.h not foundQt库未安装或cmake找不到路径确认qtbase5-dev安装手动指定CMAKE_PREFIX_PATH示例程序运行崩溃报GLX/XCB错误图形库缺失安装libgl1-mesa-dev和libxcb相关库Windows上运行exe提示缺少Qt DLL未部署Qt运行库用windeployqt工具自动拷贝依赖签字验证qt5.15.2 unknownqmake路径不对或版本冲突在Kits里移除错误qmake重新添加正确路径中文界面乱码源码编码与编译器不一致源码存为UTF-8带BOM或转义字符串代码能编译但运行就退出debug和release库混用确保配置里Debug/Release对应的Qt库一致前面几项比较常见这里多说几个带有操作细节的技巧。第一个Qt Creator里某些组件没法自动安装。你需要打开安装器主程序以维护模式运行选择添加或移除组件把缺失的编译器分组补上。不少人不知道安装器还能再被运行一次重新卸载重装其实是没必要的。第二个windeployqt的用法。在Windows下把生成的exe单独拷贝到一个空目录然后在终端里运行windeployqt 你的程序名.exe它会自动扫描exe依赖的Qt DLL、插件、翻译文件并全部拷贝到同目录。这是发布demo给同事看之前必做的一步。不过我测试时也踩过坑如果用了MinGW编译器windeployqt本身也要用同一套MinGW环境的命令行去跑否则它可能识别不了依赖。更省心的方法是让Qt Creator在构建完成后直接调用部署工具在Projects Build Settings里加自定义步骤适合长期项目。第三个关于MSVC调试器。很多用MSVC套件的人会发现项目能编译但调试按钮是灰的这是因为缺少Windows调试工具cdb。可以在Visual Studio Installer里添加Windows SDK或者单独安装对应版本的调试工具。如果只是跑demo不调试也无伤大雅但一旦开始严肃项目这个必须补上。最后再提示一个非常隐蔽的问题同时装了多个Qt版本和编译器时Windows上常见的报错是Failed to load platform plugin xcbLinux上或者platform windowsWindows上很多人以为是编译选项错了其实是环境变量或插件目录在捣乱。确认程序运行时能通过Qt的插件目录找到对应的platforms文件夹必要时在代码里设置插件搜索路径或者干脆把Qt的bin目录放进PATH。6. 环境维护与后续扩展建议装好环境、跑通demo只是Qt之路的起点。根据我个人反复安装维护的经验还有几个值得提前布局的小建议。一是掌握维护模式这个绝活。Qt安装器既是安装入口也是组件管理器。以后想补装一个模块比如WebEngine、Charts不用卸载重装打开安装器进入维护模式勾选新模块就行。这个操作很多人不知道导致换模块就跟重装系统似的。二是做好备份。我习惯把下载好的离线安装包或安装器程序单独归档到一块移动硬盘里因为官网下载页面改动频繁下次想找回特定小版本可能已经下架了。三是了解Qt版本差异。我曾经在5.15上写的项目直接换到Qt 6后遇到不少API变更比如QRegExp换成了QRegularExpression、High-DPI默认开启等如果项目要长期维护尽量早点定一个大版本方向。最后再说一个写代码之外的点Qt的构建产物路径尽量统一管理。Windows和Linux的库搜索路径、插件路径、资源编译规则都不一样首次配置一个好用且规范的CMake模板后面会省心很多。学习期间遇到报错不用慌我在上面表格里列的那些都是最常见的类型对照着排查大部分十分钟内就能解决。等到你亲手把一个窗口程序从头到尾跑起来的那个瞬间环境安装这关就算真正过了。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
