1. 为什么Qt6的安装值得单独写一篇记录Qt6从2020年底正式发布到现在版本迭代节奏一直很快。2021年那会儿Qt6.0和Qt6.1刚落地不久很多之前用Qt5的团队都在观望要不要切过来。我当时接手了一个跨平台桌面工具的项目需要同时跑在Windows和Linux上评估之后决定直接上Qt6省得以后再做一次迁移。结果光是装环境这一步就折腾了大半天踩的坑比写代码还多。这篇文章就是把我那次安装和后来几次重装的完整过程整理出来。核心关键词就三个Qt6开发环境、Qt Creator安装、卸载清理。我会把在线安装器和离线安装包的区别、组件怎么勾选、装完之后怎么验证、以及卸载时怎么把残留清干净全部讲透。适合刚接触Qt的新手也适合从Qt5迁移过来、对Qt6安装方式不太熟悉的老手。看完你至少能少走两三个小时的弯路。先说一个最容易被忽略的前提Qt6的安装方式和Qt5时代有了比较大的变化。Qt5那会儿很多人习惯下载一个几百兆的离线exe双击一路下一步就完事了。Qt6虽然也提供离线包但官方主推的是在线安装器而且账号体系、组件选择、镜像配置这些环节都有讲究。你要是直接去官网点下载很可能下到一个下载器然后卡在登录或者下载速度上。所以这篇记录的重点不只是怎么点下一步而是为什么这么点以及点错了怎么救。2. 安装前的准备工作与方案选型2.1 在线安装器和离线包到底选哪个这是第一个要做的决策。很多人上来就问哪个好其实没有绝对答案取决于你的网络环境和使用场景。在线安装器的特点是体积小通常只有几十兆启动后从官方服务器拉取你勾选的组件。优点是灵活你想装哪个版本、哪个编译器、哪些附加模块自己勾就行不用下载一堆用不上的东西。缺点是依赖网络而且如果网络不稳定下载到一半断了会很痛苦。离线安装包是把某个版本的全套组件打包好通常1到3个G。优点是下载一次之后装多少台机器都不用再联网适合团队批量部署或者网络受限的环境。缺点是包体大而且里面很多组件你可能根本用不到属于买一送十。我当时的做法是主力开发机用在线安装器因为只需要装自己用的那几个组件给测试机准备的时候用离线包省得每台都重新下。这个策略实测下来比较省事。提示无论选哪种都建议提前确认好磁盘空间。Qt6完整装下来加上编译器和调试工具占个10到20G是很正常的别装到一半发现C盘红了。2.2 账号注册这一步绕不开Qt6的在线安装器需要登录Qt账号才能继续。这个账号是免费的注册流程也不复杂但有几个细节要注意。第一注册时用的邮箱最好是你常用的因为后续下载组件、管理许可证都跟这个账号绑定。第二如果你所在的环境访问官方服务器比较慢登录环节可能会转圈很久这时候不要反复点耐心等或者换个时间段再试。第三账号本身不收费但安装过程中会问你选开源版还是商业版个人学习和小型项目选开源版就行注意看清楚开源协议的要求。我见过有人卡在登录界面以为安装器坏了其实是网络问题。判断方法很简单如果浏览器能正常打开网页但安装器一直转圈那大概率是安装器走的端口或者域名被限制了这种情况换离线包是最省心的。2.3 组件选择的思路登录之后进入组件选择界面这是整个安装过程里最需要动脑的一步。界面左边是一棵树展开后能看到Qt的各个版本、编译器、源码、附加模块等等。新手最容易犯的错就是全选结果装了几十个G实际用到的没几个。我的建议是按版本编译器必要工具三层来选Qt版本选一个稳定的主版本比如Qt6.2这种长期支持版。没必要同时装好几个大版本除非你有明确的兼容性测试需求。编译器Windows上通常选MSVC或者MinGW。如果你已经装了Visual Studio选对应版本的MSVC如果不想装VS选MinGW更轻量。Linux上一般用系统自带的GCC。必要工具Qt Creator本身、调试器、CMake或者qmake。Qt6默认推CMake但qmake也还在看你项目习惯。附加模块里像Qt Charts、Qt Multimedia这些用到再装不用提前囤。在线安装器支持后续再打开补装组件所以第一次装不用追求一步到位。3. Qt Creator安装的完整实操流程3.1 下载与启动安装器先去官方下载页面找到对应你操作系统的在线安装器。Windows下是一个exeLinux下是一个run文件macOS下是dmg。下载完成后Windows直接双击Linux需要先给执行权限再运行。Linux下的操作大概是这样chmod x qt-unified-linux-x64-online.run ./qt-unified-linux-x64-online.run启动之后安装器会先做一次自我更新检查这一步可能会花点时间。如果卡住不动可以试试加参数跳过更新但一般不建议因为新版安装器对组件的兼容性更好。3.2 登录与许可确认安装器界面会引导你登录Qt账号。输入注册好的邮箱和密码登录成功后进入许可协议页面。这里会列出开源版的使用条款仔细看一下确认符合你的使用场景后勾选同意。注意开源版和商业版的区别主要在支持和某些模块的授权上个人学习和大多数开源项目用开源版完全够。但如果你所在的项目有特殊的授权要求这一步一定要跟团队确认清楚别装完了才发现协议不匹配。3.3 安装路径与组件勾选接下来是选安装路径。默认路径通常在用户目录下但我建议改到一个空间充足、路径里不带中文和空格的目录。比如Windows下可以放D:\QtLinux下放/opt/Qt或者用户主目录下的某个文件夹。路径带空格有时候会让某些构建工具出问题虽然现在兼容性好多了但能避则避。组件勾选是重头戏。展开Qt版本树你会看到类似这样的结构组件类别具体项是否建议勾选Qt版本Qt 6.2.x是选一个LTS版本编译器MSVC 2019 64-bit装了VS就选编译器MinGW 64-bit没装VS就选这个工具Qt Creator必选工具CMake建议选工具Ninja建议选源码Qt Source按需调试时有用附加模块Qt Charts等用到再装勾选完成后点下一步安装器开始下载和安装。这个过程长短取决于网速和勾选量慢的话一两个小时都有可能。期间不要关窗口也不要让电脑休眠。3.4 安装完成后的验证装完之后别急着写代码先做几项验证确认环境是通的。第一打开Qt Creator看能不能正常启动界面语言是不是你想要的。第二在Qt Creator里新建一个示例项目比如那个经典的空白窗口应用选好套件Kit后编译运行。如果能弹出一个空窗口说明编译器和Qt库都配好了。第三检查一下套件配置在工具-选项-Kits里看看有没有黄色的感叹号有的话说明某个环节没配全比如调试器路径不对。我当时的验证方法是直接跑一个带按钮的小窗口点一下按钮弹个消息框。这个测试虽然简单但能同时验证界面库、信号槽机制和运行时环境比只看能不能编译更有说服力。4. 卸载与残留清理的正确姿势4.1 为什么卸载比安装还麻烦Qt6装完之后文件散落在好几个地方安装目录、用户配置目录、注册表Windows、系统环境变量。如果只是把安装目录删了配置文件和缓存还在下次重装可能会遇到奇怪的冲突。所以卸载要按顺序来先走官方卸载程序再手动清残留。4.2 用维护工具执行卸载Qt的在线安装器本身带维护功能。重新运行安装器登录后它会识别出已安装的组件界面里会有卸载或者添加/移除组件的选项。选中你要卸载的版本和组件确认后它会自动删除对应的文件。这是最干净的方式优先用它。如果安装器已经找不到了或者维护功能出问题那就只能手动删安装目录。但手动删之前先把Qt Creator关掉确保没有进程占用文件。4.3 清理配置文件和缓存官方卸载程序通常不会动用户目录下的配置。这些残留主要在这几个位置WindowsC:\Users\你的用户名\AppData\Roaming\Qt和AppData\Local\QtLinux~/.config/Qt和~/.local/share/QtmacOS~/Library/Preferences/Qt等这些目录里存的是Qt Creator的界面配置、最近打开的项目、插件设置等。如果你打算重装后恢复之前的习惯可以备份一下再删如果就是想彻底重来直接删掉。4.4 环境变量和注册表的处理Windows下安装时如果勾选了添加到PATH卸载后环境变量里可能还留着旧路径。手动去系统环境变量里检查一下把指向已删除Qt目录的条目删掉。注册表方面一般不需要手动动官方卸载程序会处理大部分。如果遇到重装时报已存在安装之类的提示可以用官方提供的清理工具或者手动搜索注册表里跟Qt相关的键值但这一步要谨慎不确定的别乱删。Linux下检查一下~/.bashrc或者~/.profile里有没有手动加过的Qt路径有的话注释掉或者删掉。提示卸载完成后重启一次电脑让环境变量和文件锁彻底释放再开始重装能避免很多莫名其妙的报错。5. 常见问题与排查技巧实录5.1 安装器卡在登录或下载这是最高频的问题。表现是登录界面一直转圈或者组件下载进度条不动。原因通常是网络到官方服务器的连接不稳定。排查思路先确认浏览器能不能正常访问外网如果浏览器正常但安装器不行试试换离线安装包如果坚持用在线安装器可以尝试在非高峰时段操作或者检查系统代理设置是否干扰了安装器的连接。注意这里说的是正常的网络代理配置不是任何特殊工具。5.2 编译时报找不到编译器装完Qt Creator新建项目一编译就报没有可用的编译器或者套件带感叹号。这通常是编译器没装或者路径没配对。如果是MSVC确认Visual Studio或者Build Tools装好了并且版本跟Qt要求的对得上。如果是MinGW确认安装时勾选了MinGW组件。然后在Qt Creator的套件设置里手动指定编译器和调试器的路径。调试器在Windows上一般是cdb或者gdbMinGW自带gdb。5.3 运行时报缺少DLL编译通过了但一运行就弹窗说缺少某个DLL。这是因为Qt的动态库没有在运行时被找到。开发阶段Qt Creator一般会自动处理但如果你把exe单独拷出来运行就需要把对应的DLL一起带上或者用部署工具处理。Windows下可以用windeployqt这个工具它会自动扫描exe依赖的Qt库并拷贝到同目录。命令大概是这样windeployqt your_app.exeLinux下则涉及库路径和rpath的设置相对复杂一些开发阶段一般不用操心。5.4 重装后配置混乱如果之前卸载不干净重装后可能出现套件重复、路径指向旧目录等问题。解决办法是彻底清理配置目录然后在Qt Creator里重新配置套件。实在不行就把用户配置目录整个删掉让Qt Creator恢复默认设置再重新走一遍套件配置。下面这张表可以当作速查用问题现象可能原因处理方式安装器登录转圈网络连接不稳换离线包或换时段编译无编译器编译器未装或路径错检查套件配置运行缺DLL动态库未随行用windeployqt重装报已存在残留未清清配置目录和注册表套件带感叹号某环节未配全逐项检查Kit设置5.5 几个我踩过的坑第一个坑是路径里有中文。早期版本对中文路径支持不好我把它装在了一个带中文的目录下结果CMake配置一直失败。后来换成纯英文路径就没事了。虽然新版改善了很多但养成纯英文路径的习惯没坏处。第二个坑是同时装了多个Qt版本套件里混在一起编译时选错了版本报了一堆链接错误。后来我在套件命名上加了版本号一眼就能分清。第三个坑是卸载后没清环境变量重装时安装器检测到旧路径行为变得很奇怪。从那以后我卸载完都会手动检查一遍PATH。6. 关于版本选择和后续维护的几点经验Qt6的版本更新比较频繁不建议每个小版本都追。选一个长期支持版比如6.2或者后续的LTS稳定用着就行。等有明确需求或者遇到已修复的bug时再升级。组件安装上保持按需安装的原则。在线安装器随时可以补装没必要第一次就装全。装得越多出问题的概率越大维护成本也越高。最后分享一个我自己的习惯每次装完环境把安装的版本号、组件列表、安装路径记在一个文本文件里。下次重装或者换机器的时候照着这个清单来几分钟就能配好不用再回忆当时勾了哪些东西。这个习惯帮我省了很多重复劳动尤其是隔了几个月再装的时候根本记不住细节。环境这东西装一次理顺了后面就是复制粘贴的事。关键是第一次别怕麻烦把该注意的地方都注意到后面就轻松了。