☰
Qt安装避坑指南:版本选择、编译器配置与报错解决
2026/10/8 3:46:20 网站建设 项目流程

1. 动手装之前,先选对版本和编译器组合

先说个我自己的教训。前几年帮同事处理一台新电脑,他要装Qt做Windows桌面工具,我直接甩了个在线安装器让他一路“Next”。结果他装完打开Qt Creator,新建项目时发现没有任何可用的构建套件(Kit),编译按钮全是灰的——因为他在安装向导里一个编译器都没勾。后来重装了一遍,白白浪费了两个小时。装Qt这事儿,看着是个“下一步到底”的流程,但真正决定速度快慢的,是动手前那几分钟的规划:装哪个版本、选哪套编译器、组件勾哪些。

1.1 MSVC还是MinGW:先搞清楚你的Windows环境

Windows下最常见的编译器组合就两套:MSVC和MinGW。简单说,MSVC是微软的Visual C++编译器,需要系统里装有Visual Studio(或者单独的Build Tools),Qt的MSVC套件依赖VS的环境;MinGW则是GCC在Windows下的移植版,自带编译器,装完就能用,不需要额外装VS。

怎么选?看你的使用场景:

使用场景推荐套件理由
做Windows桌面工具、对接Windows API、调用DirectXMSVC 2019 64-bit和Windows生态兼容最彻底,很多第三方库默认编译MSVC版本
纯图形界面、学习、小工具、不想装VSMinGW 8.1.0 64-bit装完开箱即用,不占VS那好几个G的空间
混合开发,可能要在Linux/Mac交叉编译MinGW或MSVC都行,建议保持跨平台代码风格编译器差异主要影响本地构建,代码层面注意别用平台私有API

我自己Windows主力机用的MSVC 2019 64-bit,因为项目里经常要调一些Windows SDK的东西;给朋友装学习用环境,我会直接选MinGW,省事。另外要注意,如果你选择MSVC套件,得先确认机器上有Visual Studio 2019或更新的Build Tools,没有的话Qt的MSVC套件装了也白装,检测不到编译器。这点在安装前就要确认,不然又是“套件灰色”的下场。

1.2 版本号怎么选:别盲目追新

网上搜“QT快速安装”,经常有人直接装最新版。但实际项目里,版本选择往往是“够用就好,兼顾稳定”。我见过的组合大概这样:

  • Qt 5.12系列:经典老将,LTS长期支持,MinGW和MSVC组件都很全,很多老项目、教学视频都基于它,社区资料最丰富。如果你要照着老教程操作,选5.12踩坑最少。
  • Qt 5.14.2:bug修正版,比较稳健,5.15之前的过渡选择。如果你需要打开某些较新的CMake项目,又不想上6.x,可以用它。
  • Qt 5.15.2:5.x系列最后一个LTS(官方对开源用户的在线安装包、离线包支持都比较成熟),也是很多人“稳定不乱升级”的主力版本。我自己现在Windows上保留的就是5.15.2,配合msvc2019_64套件。网上那些报错信息里,..\qt\5.15.2\msvc2019_64\include\qtwidget路径出现频率很高,说明这个版本普及度确实大。
  • Qt 6.x系列:新架构,重绘了很多底层模块,API和5.x有差异。好处是长期支持、性能更好,坏处是不少老教程、老第三方库可能不支持。如果你是全新项目、没有老代码包袱,可以选;想快速上手照着老资料做,还是5.15.2稳。

我的建议很直接:第一次用Qt,或者想快速装完就干活,直接用Qt 5.15.2的MSVC 2019 64-bit/MinGW套件。别拿自己当小白鼠,也别为了“新”给自己挖坑。

1.3 先规划目录再动手,避免C盘爆红

这事儿不起眼,但特影响心情。Qt的安装目录默认在C:\Qt,每个版本加各部分组件轻轻松松十几个G。我见过有人装完5.12又装5.15,C盘直接变红,然后整个开发环境开始各种卡。建议装之前规划好目录,比如D:\Qt\5.15.2这种结构。理由很简单:一是避免系统盘空间紧张,二是Qt本身的工具(比如windeployqt、MaintenanceTool)依赖目录结构,放到非中文、无空格路径下最省心。

另外,中文用户名或带空格的路径会导致部分工具链出问题,这个我在1.1提过的编译套件识别失败里也遇到过。你的Windows用户名是中文,或者系统装在C盘快到阈值,那动手前先解决这两个问题,比你后面排查半天都快。

2. 下载渠道与镜像加速:别在官网死磕

很多人卡在“快速安装”的第一关,就是下载。Qt的官方在线安装器本身在部分地区访问慢,加上安装器体积大,有时候卡在进度条上能急死人。这个问题的解法很成熟:用国内镜像。我在清华源下载时,速度能跑到满带宽,同一个安装器挂官网,五分钟都不带动一下的。

2.1 官网下载器和镜像站怎么配合

Qt官方提供统一的在线安装器,文件名叫类似qt-unified-windows-x64-4.8.0-online.exe之类的东西。它本身是个“下载器”,实际安装时再根据你勾选的组件从官网拉数据包。因为数据源在国外,国内网络环境下一卡一卡的。解决办法:用镜像站的地址,或在安装器里指定镜像仓库。

实际操作上,我不太建议新手折腾在线安装器里加镜像源的参数,直接去清华源下载离线包更省事。镜像站页面提供的文件分两类:一类是online_installers目录下的在线安装器,另一类是archive目录下偏老的安装包,里面能看到qt/5.15.2/这种版本目录。5.15.2的离线安装器文件是qt-opensource-windows-x86_64-5.15.2.exe,在存档目录里有。下载后用这个离线安装包做的最大好处是:它是完整安装包,后续不再从外部拉数据,装多快取决于你磁盘速度,而不是网络。

2.2 镜像页面上那些文件夹到底是什么意思

第一次去镜像站的人很容易懵:archive、online_installers、snapshot……到底进哪个?我常看的结构是这样:

  • archive:历史版本的完整存档,里面按大版本分文件夹(如archive/qt/5.15/5.15.2/),往里找适合你平台的安装文件。想快速获取稳定版,主要来这里。
  • online_installers:较新的在线安装器存放点,适合你想要最新版、并愿意用Qt官方在线安装流程的场景。
  • snapshot:开发快照,非必要不建议碰,稳定性没保证。

下载的时候留意文件名里的平台标识:windows-x86_64就是64位Windows版,linux-x64是Linux版。选错平台浪费时间,我见过有人下载了Linux安装包在Windows上还跑来问为什么打不开的,真不是段子。

2.3 离线包和MaintenanceTool的关系

离线包安装完,会在安装目录下生成一个MaintenanceTool.exe(部分历史版本叫MaintenanceTool)。这个工具非常重要:它可以增删组件、更新组件、甚至卸载整个Qt。比如你当前用5.15.2,想再补装一个Qt Charts模块,不用重新下载整个安装包,直接打开MaintenanceTool,它会自动通过你预先设置的软件源地址拉取数据。这个工具我后面还会重点讲。

下载环节还有一个建议:安装器下载完,先校验一下SHA/SHA256。官方页面和镜像站点一般会给出校验值。我第一次下载某版本5.12的离线包时,因为网络抖动下载文件损坏,安装到一半报错,浪费了不少时间,后来养成下载完先PYTHON或系统工具算一次SHA256的习惯,虽然多花十几秒,但避免了反复重装。

3. 安装向导逐项过:组件勾选才是重头戏

下载完毕,双击安装包。如果装的是官方在线安装器,第一步会让你登录Qt账号——没账号得注册,这块卡住的人不少。离线包则很少涉及强制登录,这也是我推荐离线包的原因之一。

安装过程中真正有技术含量的,是组件选择页面。这一步选多选少,直接影响你后续能不能快速编译出东西。

3.1 组件勾选策略:按用途来,不是全勾

组件页面分成几大块,左边是Qt版本(比如5.15.2),展开后里面有各种子模块;往下还有Tools区(编译器、CMake、Qt Creator等)。新手最容易犯的错是“全都勾上”,几十个G一会儿就过去了,还拖慢安装速度。更合适的做法是:只勾你要用的,但编译器一定要勾。

如果你跟我一样是Windows + MSVC路线,至少勾这几样:

  • Qt 5.15.2下的MSVC 2019 64-bit(如果你有VS2019环境)或MinGW 8.1.0 64-bit(如果你走MinGW)
  • Qt Creator(IDE本体,有时候会自动带上)
  • 调试工具和Qt Debug Information Files(如果选项里能看到,勾上,崩溃调试能省事)
  • 你项目里需要的模块,比如做图表就用Qt Charts,做Web嵌入就用Qt WebEngine

Qt Charts这个好几个朋友问过:默认安装往往不勾,但你在项目文件里用了QT += charts,编译时一堆“找不到头文件”的报错,就是因为没装对应模块。同理,Qt Data Visualization、Qt WebEngine这些模块按需勾。别全选,也别漏选,项目里需要什么装什么。

3.2 “Developer and Designer Tools”里都藏着什么

组件列表里还有一个容易被忽略的区域,叫Developer and Designer Tools或类似的Tools部分,里面包含:

  • Qt Creator XXX(IDE):可视化开发环境,界面设计器(Qt Designer)也集成在里面。
  • MinGW XXX(编译器):你选MinGW套件的话,这里会出现对应版本的编译器,必勾。选MSVC时这里则不需要,因为编译器在Visual Studio里。
  • CMake:新版Qt Creator和很多现代项目默认用CMake构建系统,不装的话打开CMake工程会提示找不到CMake。
  • Ninja:可选的构建后端,装了能加快部分项目的编译速度。

勾选时有几个“必点”我心里有数:MinGW路线就勾MinGW编译器;不管什么路线,CMake最好勾上。这样后面打开别人给的CMake工程,不会卡在“No suitable kit found”这种问题上。

3.3 安装路径与目录结构的一次到位

安装向导里有一步是选择安装目录。我建议直接指定到类似D:\Qt这样的非系统盘。和1.3说的一样,别用带空格、带中文的路径,也别用默认的C盘。装完以后,目录下会形成类似下面的结构:

D:\Qt\ 5.15.2\ msvc2019_64\ bin\ include\ lib\ plugins\ qml\ ... Tools\ QtCreator\ CMake_64\ MinGW...

bin目录下就是qmake.exe、windeployqt.exe这些命令行工具。后面配置环境变量、部署程序都要用。这个结构你熟悉了,出问题的时候找路径也快。

安装过程的第3步到第5步一般很快,慢的是组件下载和解压。离线包会好很多。装完后建议先别急着关,看一下有没有“Setup completed”之类字样,如果中途报错,截图记录再排查——最常见的错误是磁盘空间不足或权限不足,给安装程序“以管理员身份运行”往往能解决后一个。

4. 安装后的环境变量与构建套件自检

装完Qt只是第一步,真正决定“有没有装好”的,是你能不能成功创建一个项目并编译运行。很多人卡在这一步,要么环境变量没配,要么构建套件识别失败。快速判断安装环境是否可用,我有套完整的自检流程。

4.1 PATH和QTDIR设置实践

Windows下,Qt的很多工具(比如qmake、moc、uic)在bin目录里。如果你希望命令行里直接敲qmake就能用,建议在系统环境变量里做两件事:

  1. 新建一个环境变量QTDIR,值填Qt版本所在的根目录,比如D:\Qt\5.15.2\msvc2019_64。这样第三方工具链能自动找到Qt的位置。
  2. 把Qt的bin目录追加到PATH,比如D:\Qt\5.15.2\msvc2019_64\bin。这样qmake.exe、windeployqt.exe等工具才能在任意终端里直接调用。

注意,不同套件的bin目录不同,别配错。配置完最好重新开一个cmd或者PowerShell窗口,让环境变量生效。然后跑一下qmake -v,如果提示找不到命令,多半是PATH没生效或路径配错了。

C:\> qmake -v QMake version 3.1 Using Qt version 5.15.2 in D:\Qt\5.15.2\msvc2019_64\lib

出现这个,说明环境变量没问题。如果提示找不到,先检查路径里是否有空格或中文,这类问题最坑人。

4.2 命令行编译第一个小程序

环境变量配好,我习惯用一个“最小可编译项目”验证整个工具链。创建一个文件夹,比如D:\tmp\hello_qt,里面放一个main.cpp:

#include <QApplication> #include <QLabel> int main(int argc, char *argv[]) { QApplication a(argc, argv); QLabel label("Qt installed and working!"); label.resize(300, 100); label.show(); return a.exec(); }

再放一个hello_qt.pro:

QT += widgets SOURCES += main.cpp

然后在命令行里执行:

qmake mingw32-make

如果你用的MSVC套件,编译器命令可能是nmake。看到生成hello_qt.exe后,直接运行,窗口弹出来就算全链路通了。这一步虽然比“在Qt Creator里点运行”麻烦点,但能快速确认环境本身没问题——一旦后续在Qt Creator里遇到编译失败,你就知道是Creator配置或Kit的问题,而不是整个安装环境的问题。

4.3 Qt Creator的Kit识别与手动修正

双击打开Qt Creator,它会在“工具→选项→Kits(构建套件)”里自动扫描编译器、Qt版本、CMake等。点开Kits页面,看你的套件是不是带黄色警示图标。如果编译器一栏显示“No compiler”,说明你虽然装了MinGW或MSVC,但Qt Creator没识别到。常见原因:

  • 安装Qt时没有勾选MinGW编译器组件(在Tools下),或者MSVC套件对应的VS版本有缺。
  • 安装路径里带中文/空格导致扫描异常。
  • 新装完组件,Qt Creator没有重新扫描,重启一下即可。

手动修正也很简单:在Kits页面点“手动设置”,Compiler页签里添加编译器路径,比如MinGW的g++在D:\Qt\Tools\mingw810_64\bin\g++.exe;然后Qt Versions页签里添加qmake.exe路径;最后回到Kits把三者关联起来。关联完,点一下右下角“Apply”,新建项目时这个Kit就能用了。

这一点坚持下来能省很多时间:装完不一定立刻写代码,但一定要先自己建一个空项目试编译。空项目能过,后面业务代码慢慢写;空项目都过不去,就先把环境修好,否则你写的所有代码都会堆在“编译不过”这个泥潭里。

5. 最经典的安装后翻车现场:qt.qpa.plugin报错

如果上面自检全过了,恭喜,你的开发环境基本就绪。但你别急着发布软件——因为发布阶段还有一个超高频率的报错,网上搜“QT快速安装”出来一堆相关热搜词,其中就有这个:“qt.qpa.plugin: could not find the Qt platform plugin "windows" in ""”。这个错我踩过,也帮别人查过很多次,今天详细拆一遍。

5.1 报错长什么样,根因就是没找到platform插件

你双击一个编译好的Qt程序,如果它弹出类似这样的黑色命令行窗口并报错:

qt.qpa.plugin: could not find the Qt platform plugin "windows" in "" This application failed to start because no Qt platform plugin could be initialized.

原因是:Qt的窗口系统是通过动态加载bin上一级的plugins\platforms目录下的插件(比如qwindows.dll)来实现的。发布时如果只把exe拷走,没带platforms文件夹,程序找不到“创建窗口的底层插件”,自然崩。

如果你是在开发环境里跑源码编译出来的程序也遇到这个错,还有一种情况:环境变量QT_QPA_PLATFORM_PLUGIN_PATH没设置,或者指向了不存在的路径。此时Qt在""(空路径)里找插件,找不到才报这个错。我排查过不少拿到别人源码、自己编译后运行报这个错的情况,十有八九是因为没有在程序里设置插件目录,或者用Qt Creator跑时Creator没自动注入。

5.2 修复手段按顺序试

针对不同阶段,修复方法不一样:

  1. 开发时运行报错:在main函数里,或在调用QApplication之前,先设置插件目录。比如:
#include <QApplication> #include <QDir> int main(int argc, char *argv[]) { QApplication::setLibraryPaths(QStringList() << QDir::current().filePath("plugins")); // 或者指定到本地Qt安装目录的plugins QCoreApplication::addLibraryPath(QStringLiteral("D:/Qt/5.15.2/msvc2019_64/plugins")); QApplication a(argc, argv); // ... }

不过更常见的做法是配置好QT_QPA_PLATFORM_PLUGIN_PATH环境变量,指向D:\Qt\5.15.2\msvc2019_64\plugins\platforms,然后重开程序。这个变量是让Qt在运行期能找到插件所在的额外搜索路径。

  1. 发布时运行报错:把plugins\platforms整个文件夹复制到exe同级目录,并确保qwindows.dll在里面。发布目录结构一般是这样:
发布目录\ MyApp.exe platforms\ qwindows.dll

如果没有platforms文件夹,程序双击就报上面的错。很多新手在“发布”这一步懵掉,就是这个原因。Qt自带的部署工具windeployqt.exe干的就是这件事:自动帮你把exe依赖的Qt DLL、插件目录、平台插件、样式插件等一次性补齐。用法很简单,在命令行里切换到exe所在目录,执行:

windeployqt MyApp.exe

它会自动处理大部分部署问题,包括platforms目录。发布前跑一次这个命令,是必要条件,不是可选操作。不过依赖了非Qt的第三方库时,windeployqt管不了,得自己拷贝。

5.3 发布时的其他坑:Control,别只在开发机上是好的

除了platform插件,发布时最常见的就是“在开发机上一切正常,考到别的机器上就崩溃”。Qt的发布有一个基本原则:dev机器上安装了多少依赖,发布包里就得有对应的运行时DLL。比如你用MSVC编译,可能需要把libgcc、libstdc++(MinGW路线)或对应的VC运行时库带上。用windeployqt处理完以后,最好先在一台干净虚拟机或没装Qt的机器上跑一遍,验证是不是真的“绿色免安装”。我之前有一次发布工具,在开发机上双击很流畅,拷到客户电脑上直接闪退,后来查半天发现是少了icudt*.dll,就是因为发布时没完全跑完windeployqt,而且依赖了ICU模块但没带上相关文件。这个小插曲让我记住了:发布前的干净环境验证,比什么都重要。

6. 换个系统再来一遍:Ubuntu与国产系统下的快速安装

“QT快速安装”这个需求不只出现在Windows上。最近几年Linux桌面要跑Qt开发的越来越多,Ubuntu是最常见的开发环境,也有在国产桌面系统(比如基于Debian系的麒麟系统)上装Qt写应用的需求。有些细节和Windows差异很大,我分别说下最快路径。

6.1 Ubuntu下最省事的Apt安装方式

Ubuntu下安装Qt开发环境,优先级最高、最快的是系统包管理器。以Ubuntu 22.04(或基于它的发行版)为例,终端执行:

sudo apt update sudo apt install qtbase5-dev qtchooser qt5-qmake qtcreator

这几行装完,你就有Qt5开发库、qmake和一个能用的Qt Creator。想确认装的是哪个版本,执行:

qmake --version

Ubuntu 22.04仓库默认大概是Qt 5.15.x,够学习和小型项目用了。这种方式速度奇快,但有个局限:仓库包未必覆盖所有Qt模块(比如Qt Charts可能要额外装libqt5charts5-dev)。如果你要装的是最新版Qt 6或更完整的模块,就得去用官方在线安装器,或者自己从源码编——后者我不建议新手碰,太容易消耗耐心。

Apt装的另一个好处是依赖处理很干净,不用手动配环境变量,系统路径里直接就能用qmake和qtcreator。

6.2 用官方安装器装Linux版需要注意的权限问题

如果你需要特定版本(比如5.12、5.15.2的非系统默认版本),从下载页拿qt-opensource-linux-x64-5.15.2.run之类的文件,给执行权限后运行:

chmod +x qt-opensource-linux-x64-5.15.2.run ./qt-opensource-linux-x64-5.15.2.run

图形界面画风跟Windows版基本一致,组件选择逻辑也一样。要注意的是Linux下如果遇到“Qt platform plugin”相关报错,检查一下libxcb*相关的依赖是否齐全——Linux的Qt窗口系统依赖X11,缺了XCB库Qt起不了界面。根据报错信息用apt install --fix-broken或手动补装依赖包通常能解决。以及如果是远程SSH/容器环境想跑GUI,还要配置X11转发,这个就是纯环境问题,不在安装范畴内。

很多Linux上编译Qt程序时还会遇到“找不到头文件”“找不到Qt库”的错,多半没装开发符号包。用Apt时安装带-dev后缀的包;如果用.run包,就检查安装时是不是没勾对应模块。Linux下环境配置没有Windows那么依赖PATH变量,但如果你手动编译时报错找不到Qt5Widgets/QtWidgets,先检查pkg-config能不能找到Qt5:

pkg-config --modversion Qt5Widgets

找不到就装libqt5widgets5相关开发包。这一类问题都是“基础依赖没补齐”,比Windows简单,但新手会绕圈。

6.3 在国产系统上走在线安装的实际操作

国产桌面系统(如麒麟系)常见的底层还是类似Debian的包管理,终端里sudo apt的用法通常还在。先确认系统架构是x86_64还是aarch64(比如飞腾、鲲鹏平台的机器)。如果是aarch64,安装时丰俭由人:

  • 能直接用系统仓库装Qt的话,sudo apt install qtbase5-dev qtcreator基本能通;
  • 如果仓库里没有你要的版本,到Qt下载页找linux-aarch64对应的在线安装器,运行后组件选择和Windows/Linux一致;
  • 装完后如果出现菜单栏中文乱码或字体异常,检查系统有没有装中文字体(如文泉驿、Noto CJK),缺了字体不一定会导致安装失败,但界面看着确实难受。

国产系统上有时会遇到Qt Creator启动后白屏/黑屏,多半是显卡驱动或OpenGL实现的问题。Qt Creator的启动模式可以在快捷方式里加-platform xcb或用软件渲染模式。这个经验是从实践中试出来的:QT_OPENGL=software qtcreator能强制走软渲染,界面基本能出来。当然,如果系统本身有没有正确安装GPU驱动,还是先解决驱动问题更根本。

7. 卸载、清理与版本共存:装坏了怎么优雅回滚

“快速安装”的另一个隐含问题是:装错了怎么快速卸掉,或者怎么让多个版本和平共处。我见过有人装完6.0又想退回5.15,直接在文件管理器里把C:\Qt文件夹删了,结果文件被占用删不干净,重新装又各种残留问题。正确解法其实很简单。

7.1 MaintenanceTool的正确打开方式

Qt安装目录下有个MaintenanceTool.exe,它以管理员身份运行后,提供三项核心功能:

  • 添加或移除组件:想补装Qt Charts、想删除没用的模块,走这一步。
  • 更新组件:小版本更新、补丁更新,走这里。
  • 卸载全部组件:彻底移除当前安装的这套Qt。

卸载时它会扫描已安装组件并列出清单,确认后逐步卸载。如果你要彻底“清掉重来”,先运行MaintenanceTool卸载组件,卸载完再检查残留,这不比手工删除省力得多。注意:在线安装器版本的MaintenanceTool需要联网,离线包安装的话它可能提示“需要在线更新”,这时候得让它通过镜像源访问或者另外处理,但5.15.2那代离线安装器的MaintenanceTool基本是能用的。

7.2 卸载后的残留处理

MaintenanceTool卸载完,并不意味着机器上干干净净。残留主要在几个地方:

  • C:\Users\你的用户名\.qmake.conf、.qmake.cache这类隐藏配置,旧的qmake路径信息可能留着
  • C:\Users\你的用户名\AppData\Roaming\QtProject、QtCreator等配置目录,记录了旧的Kit信息
  • 注册表里的HKEY_CURRENT_USER\Software\QtProject、HKEY_CURRENT_USER\Software\Digia等键值

如果卸载后重新安装不同版本,发现Qt Creator里还残留旧Kit,或者编译时弹出旧路径,最好把这些用户目录下的Qt相关配置也清掉。我操作时会先备份整个用户目录下的QtProject/QtCreator配置,确认新版本没问题了再删,毕竟里面可能有你精心配的代码风格、快捷键。

7.3 多版本共存的目录放法和切换技巧

有时候你要同时用5.12和5.15,一个项目必须老版本编译,另一个项目需要新模块。多版本共存完全可行,只要注意:

  • 安装时把版本放在独立的子目录,比如D:\Qt\5.12.12、D:\Qt\5.15.2,不要覆盖安装成同一目录。
  • 环境变量QTDIR每次指向你当前要用的版本。或者更简单:不设全局QTDIR,直接在Qt Creator的项目构建设置里指定每个项目用哪个Qt版本(Kit级别指定)。
  • 命令行里切换版本,更推荐用Qt自带的qtchooser(Linux下有,Windows可以手写个小脚本改PATH)。Windows下我习惯做一个switch_qt.bat:
@echo off set QTDIR=D:\Qt\5.15.2\msvc2019_64 set PATH=%QTDIR%\bin;D:\Qt\Tools\QtCreator\bin;%SystemRoot%\system32

要用5.12就同理改成5.12的路径。这个脚本只对当前终端生效,不影响其他程序,实测下来多版本切换最顺手。

多版本并存时,最容易踩的坑是:在Qt Creator里新建项目时,Kit指定了Qt版本,但编译时编译器却用错了顺序。比如MSVC 2019套件配了5.15.2的qmake,但链接器还是找Visual Studio里的默认版本。这类问题多半在Kit配置里就能解决:把Compiler、Qt Version、CMake三者明确对应到同一套链上,别让Qt Creator自动匹配一个模棱两可的配置。


最后再分享一个我自己的习惯:装完Qt第一件事,建一个最小窗口程序,编译运行成功后再拷贝到另一台没装Qt的机器上跑一遍。前者验证开发环境,后者验证部署依赖。这样处理过后,后续写业务代码时才不会被底层环境问题反复打断。装Qt这件事,本质不是“点几下Next”能搞定的,而是在合理规划下把版本、编译器、组件、运行时这四样东西一次配齐。你把这套流程走顺了,以后不管Windows还是Linux,装什么环境心里都有底。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询