1. 为什么我用 Visual Studio 而不是 Qt Creator 来写 Qt 桌面软件我手上大部分桌面项目都是 Visual Studio 2022 Qt 5.15.2 的组合只有纯演示性质的小工具才会打开 Qt Creator 图个方便。这不是说 Qt Creator 不好它开箱即用、跨平台一致、和 qmake/CMake 的配合也更原生但只要项目一上规模——模块数超过十几个、要接第三方编译好的库、要和 C# 写的上位机共用一批底层代码、团队里有人只会 VS——Visual Studio 的优势就会明显盖过它的启动速度优势。Vitual Studio 在这里扮演的角色是工程管理与调试宿主Qt 负责的是界面、事件循环、跨平台抽象层。二者结合之后你得到的是MSVC 的编译与优化能力、VS 的调试器条件断点、内存窗口、并发可视化、性能探查器、完整的 IntelliSense 与重构能力同时又能用 Qt 的信号槽、样式表、布局系统把界面快速搭出来。1.1 两套工具链的本质差异先把概念理清楚很多人卡在第一步就是因为把工具链混为一谈了。Qt Creator 是一个 IDEQt 是一套库qmake/CMake 是构建系统MSVC/MinGW 是编译器。这四件事彼此独立。Visual Studio 本身就是 IDE 编译器 调试器的集合体所以当你想在 VS 里用 Qt实际上要做的只是让 VS 用 MSVC 编译你的代码并且在链接阶段把 Qt 的库接上同时在编译前自动跑一遍 moc/uic/rcc 这三个代码生成器。Qt Creator 的典型组合是 Qt qmake MinGWWindows 上默认给的就是 MinGW 版本。而 VS 只能配 MSVCMinGW 编译出来的 Qt 库在 VS 里是用不了的ABI 不兼容链接阶段直接报一堆undefined symbol。这一点务必记住下载 Qt 的时候一定要选msvc2019_64或者msvc2019_32这类带 msvc 字样的组件包别下成mingw81_64。反过来也一样MSVC 编译的 Qt 库没法拿到 Qt Creator 里配合 MinGW 用。两边可以共存只要各自配好各自的 Kit / Qt Version。1.2 哪些桌面软件项目更适合这套组合按我的经验下面几类项目放在 VS 里做会舒服很多。需要集成编译好的第三方 SDK。比如机器视觉类的算法库、工业相机的驱动、报表控件、加密狗接口。这些 SDK 通常只给 MSVC 的.lib.dll甚至只给 VS 的工程样例。Qt Creator 里虽然也能手动填INCLUDEPATH和LIBS但一遇到需要按 Debug/Release 分别链接不同的 lib、需要设置工作目录、需要 Copy 一堆运行时依赖VS 的属性页系统就明显更好管理。和 C#/WPF 项目混在一个解决方案里。上位机场景很常见主程序是 C#底层通信和图像处理是 C/Qt 写的一个独立进程或者 DLL。VS 的解决方案资源管理器可以一次性把十几个项目装进去统一编译顺序这点 Qt Creator 做不到。团队协作且团队里大部分人只用过 VS。VS 的可视化调试和代码导航门槛更低新人接过项目半小时能看懂结构换成 Qt Creator 得先适应一套新快捷键和目录视图。重度依赖 Windows API 的场景。比如要改窗口的扩展样式、要挂全局热键、要做无边框拖动、要处理 DPI 缩放、要做窗口分屏管理类似开源的分屏工具那种逻辑SetWindowPos 监听WM_WINDOWPOSCHANGINGVS 这边的头文件和文档体验更顺。反过来说如果你的项目要做纯 QML 的移动端风格界面、要在 Linux/macOS 上同步开发、或者就是个几百行的内部小工具那 Qt Creator 更省事没必要折腾。1.3 上手前必须想清楚的三件事第一Qt 版本定死。我建议新项目直接上 Qt 5.15.2 或者 Qt 6.5 以上的 LTS。5.15.2 是最后一个提供完整离线安装包的 5.15 版本生态成熟、绝大多数第三方库都适配过Qt 6 的界面渲染更好但部分老库还没跟上。第二编译器版本对齐。VS2022 带来的是 v143 工具集而官方预编译的 Qt 5.15.2 用的是 v142VS2019。这两者是二进制兼容的直接链接不会出问题这是微软承诺过的。但如果你要用 VS2022 自己从源码编译 Qt那你得额外装一堆依赖Perl、Python、Ninja第一次编译 5 小时起步不值得直接用官方预编译包就行。第三要不要用 Qt VS Tools 插件。我的建议是一定要用它把 moc/uic/rcc 的自动化、.ui文件的可视化编辑、qmake 工程导入、Qt 版本切换这些都集成了。手动配置不是不行但每次加一个新模块都要改一遍属性页长期维护成本太高。后面第 3 章我会把不用插件的兜底方案也写清楚万一插件出问题你有退路。2. 环境搭建从装包到第一次编译跑通环境这一段是整个流程里最容易翻车的地方。我见过太多人卡在装完了但一编译就说找不到 QApplication。问题绝大多数不在代码而在包的选型和路径的绑定。下面按顺序来。2.1 Qt 包的选择离线包、版本、镜像先说版本。官方从 Qt 5.15 开始就逐步转向在线安装器了需要注册账号登录才能装而且安装器本身也分版本。历史归档里能直接拿到的完整离线安装包主要集中在这几个版本离线包情况编译器包适用场景Qt 5.12.12有msvc2017老项目维护部分工控软件还在用Qt 5.14.2有msvc2017稳定模块齐全Qt 5.15.2有msvc2019 32/64我个人最常用推荐Qt 6.2 / 6.5 LTS主要走在线安装msvc2019_64新项目界面效果更好下载渠道上官方归档站点有时候速度感人国内清华、中科大这些高校镜像站以及部分企业镜像长期同步了 Qt 的归档目录把官方路径里的official_releases/qt/5.15/5.15.2/这段结构照搬过去就能找到同一个文件。用镜像下载前记得核对一下文件大小和哈希我遇到过一次镜像同步不完整导致安装到一半报错的情况。安装的时候组件勾选有讲究在Qt节点下只勾你要用的编译器和位数。如果你是 64 位开发勾MSVC 2019 64-bit就够别的 msvc32、mingw、UWP、Android、WebAssembly 全可以不勾。这一下能省下十几 GB 空间。在同一个版本节点下面往下滚会看到Additional Libraries这里才是重点。Qt 的默认安装并不包含全部模块像Qt Serial Port、Qt Charts、Qt SQL的驱动、Qt WebSockets、Qt Multimedia这些都是可选项。Qt Creator和Qt Debug Information Files建议勾上。前者方便你偶尔对比验证后者是调试时能单步进入 Qt 源码的关键不装的话调试时只能看到汇编。注意安装路径里绝对不要出现中文和空格。D:\Qt\5.15.2\msvc2019_64这种最稳妥。带空格的路径会让一部分构建脚本的参数解析出错报错信息还特别隐晦。2.2 Visual Studio 安装时的组件勾选VS 走的是 Visual Studio Installer安装界面里工作负载选项卡勾选使用 C 的桌面开发然后在右侧的安装详细信息里确认这几项MSVC v143 - VS 2022 C x64/x86 生成工具Windows 10 SDK或Windows 11 SDK选一个装最新的即可Qt 默认用的是 10.0 那套C CMake 工具用于 Windows如果你打算用 CMake 工程就必须要适用于 Windows 的 C ATL视情况一般用不上社区版Community完全够用功能上和专业版在编译、调试这块没差别只是少了企业级的团队协作和测试工具。安装包本身有几个 GB装完 20 GB 上下装在系统盘或者单独的固态盘上都可以但同样避免中文路径。如果你之前装过旧版 VS 想卸载重装用 Visual Studio Installer 里的更多 → 卸载就行手动去控制面板删文件夹会留下残留的注册表项之后装新版可能出现could not find any instance of Visual Studio这类找不到实例的报错处理起来很麻烦。2.3 Qt VS Tools 插件的安装与绑定打开 VS菜单栏扩展 → 管理扩展 → 联机搜索Qt Visual Studio Tools安装后关闭 VS 会提示重启重启时它会自动完成安装。重启后菜单栏会多出扩展 → Qt VS Tools。第一步是绑定 Qt 版本点Qt VS Tools → Qt Versions。点右上角的选择Add new Qt version。在弹出的对话框里填入qmake.exe的完整路径也就是D:\Qt\5.15.2\msvc2019_64\bin\qmake.exe。这一步选完 qmake 之后插件会自动读出版本号、编译器、位数。给这个版本起个一眼能认出编译器的名字比如Qt5.15.2-msvc2019-64。等你同时装了 5.15.2 和 6.5 两套环境的时候这个名字能救命因为切换 Qt 版本就是在这个下拉列表里选。关于插件的版本适配Qt VS Tools 的 2.x 系列主要在 VS2019 上验证3.x 开始对 VS2022 支持更好。如果你的 VS 是 2022装最新版基本没问题如果插件装上后菜单不显示或者点开报错先检查 VS 的版本和插件支持矩阵最省事的做法是升级 VS 到最新的小版本。2.4 怎么判断环境真的通了我的习惯是先建一个最小的验证工程别一上来就开大项目。文件 → 新建 → 项目在搜索框里输入Qt会出现Qt Widgets Application、Qt Console Application、Qt Quick Application几个模板。选 Widgets语言选 C下一步时会让你指定Qt Version和Project Typeqmake 还是 CMakeQt Version 选刚才绑定的那个。工程建好之后CtrlF5直接运行。如果弹出一个空白窗口恭喜环境通了。如果报错大概率是下面几种Cannot find Qt installationQt Versions 里路径填错了或者填的是 Qt Creator 的路径。LNK1104 无法打开文件 Qt5Core.lib绑定的 Qt 版本位数和工程的平台x64/x86不匹配去生成 → 配置管理器里检查平台。编译到 moc 阶段报moc failed通常是路径里有中文或空格。这一步过了再往下做才有效率。3. 工程结构怎么搭以及不用插件的兜底做法3.1 第一个 Qt Widgets 工程里都有什么用 Qt VS Tools 模板建出来的工程目录结构大致是这样MyApp/ ├── MyApp.sln ├── MyApp.vcxproj ├── MyApp.vcxproj.filters ├── main.cpp ├── MyApp.h ├── MyApp.cpp ├── MyApp.ui ├── MyApp.qrc 可选 └── x64/ 生成目录关键点在于头文件MyApp.h在 VS 里的项类型被设成了Qt Meta-Object Compiler (moc)。这个设置是插件自动加的它让 VS 在编译前对每个带Q_OBJECT宏的头文件跑一遍 moc生成moc_MyApp.cpp并自动加入编译。.ui文件同理会被 uic 处理成ui_MyApp.h。这里有个我踩过多次的坑如果你手动把某个头文件从工程里移除再添加现有项加回来插件不会自动给它设置项类型结果就是编译能过、链接时报无法解析的外部符号 staticMetaObject。解决办法是右键那个头文件 → 属性 → 常规 → 项类型 → 手动改成Qt Meta-Object Compiler (moc)。同理.ui文件要设成Qt User-Interface Compiler (uic).qrc要设成Qt Resource Compiler (rcc)。3.2 qmake 和 CMake 怎么选Qt 5 时代 qmake 是默认Qt 6 时代官方主推 CMake。放在 VS 里两者的体验差别其实不大因为 Qt VS Tools 都能接管。对比项qmakeCMake语法简洁度简单QT serialport一行搞定需要find_packagetarget_link_librariesQt6 支持仍支持但逐渐边缘官方主推第三方库集成INCLUDEPATH/LIBS直接写用target_include_directories更规范VS 内体验Qt VS Tools 转成 vcxprojVS 原生支持打开 CMake 工程跨 IDE靠 qmake 自己通吃我的建议维护老项目继续用 qmake新项目一律 CMake。特别是你项目里要用到 OpenCV、PCL、halcon 这类本身就提供 CMake 配置文件的库时CMake 能省掉大量手写路径的工作一句find_package(OpenCV REQUIRED)加上target_link_libraries就完事。如果是 CMake 工程在 VS 里打开直接文件 → 打开 → CMake选中CMakeLists.txt。VS 会自动跑配置生成out/build/x64-Debug这样的目录。想改配置就编辑顶部的CMakeSettings.json加-DCMAKE_PREFIX_PATHD:/Qt/5.15.2/msvc2019_64这类参数让 CMake 找到 Qt。3.3 完全不用插件的配置方式有些公司环境不允许装 VS 扩展这时候就得手动配。步骤不复杂但很繁琐记下来备用。在项目的属性页里右键项目 → 属性C/C → 常规 → 附加包含目录加上D:\Qt\5.15.2\msvc2019_64\includeD:\Qt\5.15.2\msvc2019_64\include\QtCoreD:\Qt\5.15.2\msvc2019_64\include\QtGuiD:\Qt\5.15.2\msvc2019_64\include\QtWidgets链接器 → 常规 → 附加库目录D:\Qt\5.15.2\msvc2019_64\lib链接器 → 输入 → 附加依赖项Qt5Core.lib;Qt5Gui.lib;Qt5Widgets.libC/C → 语言 → C 语言标准ISO C17 (/std:c17)Qt 5.15 要求至少 C11Qt6 要求 C17别忘了预处理器的定义这是最常漏的一步Debug 配置加_DEBUG和QT_QML_DEBUG如果用了 QMLRelease 配置加QT_NO_DEBUGmoc 的处理要么在自定义生成步骤里手写命令行moc.exe xxx.h -o moc_xxx.cpp要么干脆在代码里#include moc_MyApp.cpp不推荐但确实能用。所以回头看插件省掉的是几十行重复配置和一堆容易出错的命令行值得装。实操心得VS 的调试器默认不会在控制台显示qDebug()的输出。程序在调试模式下运行时输出会进输出窗口的调试页如果不挂调试器直接运行就得用 DebugView 这类工具去抓。很多新手以为 qDebug 没生效其实是被重定向了而已。4. 界面、逻辑、绘图与数据真正写代码的部分4.1 .ui 文件在 VS 里的完整工作流在 VS 里双击.ui文件会用 Qt Designer 打开插件内置的不需要单独装。拖控件、设布局、改 objectName保存。这里有个习惯必须养成每个要访问的控件的 objectName 都改成语义化命名btnStart、listLog、labelStatus别留着pushButton_1、pushButton_2。因为 uic 生成的ui_MyApp.h里控件指针就是按 objectName 命名的命名混乱后期维护会失控。布局方面我的原则是能自动布局就不写死坐标。Qt 的QHBoxLayout、QVBoxLayout、QGridLayout、QFormLayout加上Spacer撑开基本能解决 95% 的排版需求。剩下的用setContentsMargins和setSpacing微调。窗口缩放时的表现是检验布局质量的唯一标准。拖一下窗口边缘看看控件是不是按预期拉伸或固定。如果发现某个控件被压扁了多半是没设sizePolicy或者是minimumSize没给够。在代码里访问控件就是ui-btnStart。注意ui是Ui::MyAppClass类型的指针成员在setupUi(this)之后才能用构造函数里要先调ui-setupUi(this)再做别的初始化。4.2 信号槽的三种绑定方式Qt 的信号槽在 VS 里有三种写法各有适用场景。第一种Designer 里可视化绑定。点菜单编辑 → 信号/槽编辑器然后编辑 → 连接到槽把按钮的clicked()连到窗口的on_btnStart_clicked()。这个命名规则是 Qt 的自动连接机制on_objectName_signalName形式的槽函数会被QMetaObject::connectSlotsByName自动连上不需要手写 connect。适合快速原型。第二种代码里用新式语法 connect。connect(ui-btnStart, QPushButton::clicked, this, MyApp::onStartClicked); connect(m_worker, Worker::progressChanged, this, MyApp::updateProgress, Qt::QueuedConnection);这是我最推荐的方式。编译期检查函数签名写错参数类型直接编译不过比老式的SIGNAL()/SLOT()宏安全太多。老式宏语法在运行时才检查拼错了只会在输出窗口打一行警告程序照跑不误这才是最坑的。第三种lambda 捕获。connect(ui-btnDelete, QPushButton::clicked, this, [this, rowIndex]() { m_model-removeRow(rowIndex); });适合同一批控件需要带上下文参数的场景比如表格里每行一个删除按钮。用 lambda 要注意捕获方式[]会拷贝this指针控件销毁后回调还可能被触发稳妥做法是[this]并且确保生命周期一致。跨线程的信号槽要注意连接类型。默认的AutoConnection在跨线程时自动变成QueuedConnection参数会被拷贝放进事件队列所以自定义类型必须先用qRegisterMetaType注册否则运行时报Cannot queue arguments of type XXX。4.3 Qt 绘图与自定义控件的性能考量写桌面软件迟早要画点东西曲线、仪表盘、状态指示条、自定义的卡片列表。Qt 的绘图体系分三层QPainter直接画灵活、可控、QGraphicsScene/QGraphicsView场景图适合大量可交互图元、Qt Charts现成的图表控件。QPainter的用法是在控件的paintEvent里void GaugeWidget::paintEvent(QPaintEvent *event) { QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing, true); painter.setRenderHint(QPainter::SmoothPixmapTransform, true); // 先算好几何区域再绘制 QRectF rect rect().adjusted(4, 4, -4, -4); painter.setPen(QPen(QColor(#2b7de9), 3)); painter.drawArc(rect, 225 * 16, -270 * 16); }性能上有几个实测出来的结论。开启Antialiasing会让绘制开销增加 2-3 倍在静态界面上无所谓但如果要做每秒 30 帧以上的实时曲线建议只对需要平滑的元素单独开或者干脆关掉。频繁update()是最常见的性能杀手正确做法是数据变化时用update(rect)只刷新变化区域并且用定时器合并重绘比如 30ms 一次而不是每次都全窗口刷新。如果你要做的是左右平滑滑动的卡片列表那种效果不要自己算每帧坐标用QPropertyAnimation配QSequentialAnimationGroup或者干脆用QScroller做惯性滚动代码量能少一个数量级效果还更自然。4.4 中文编码与 JSON 读写这两个话题看似不相关实际上经常一起出现从服务器拿到 JSON、解析出中文、显示到界面上中间任何一环的编码搞错就是乱码。编码问题。MSVC 在不加任何选项时源文件里的中文按系统本地代码页简体中文环境是 GBK解释。如果你把源文件存成 UTF-8 不带 BOM编译出来的字符串常量就会乱。解决办法有两条一是编译选项加/utf-8在C/C → 命令行 → 其他选项里填进去二是在.pro或者CMakeLists.txt里统一设置// main 函数最开头Qt5 下建议加上 #if QT_VERSION QT_VERSION_CHECK(6, 0, 0) QTextCodec::setCodecForLocale(QTextCodec::codecForName(UTF-8)); #endifQt 6 已经默认按 UTF-8 处理这段判断可以去掉依赖。另外源文件一定要存成UTF-8 带 BOM或者纯 UTF-8 并在编译选项里声明两者保持一致别一半文件 GBK 一半 UTF-8那才是真的灾难。JSON 读写。Qt 自带的QJsonDocument、QJsonObject、QJsonArray足够应付绝大多数配置文件和数据交换需求不需要引第三方库。// 读取 QFile file(config.json); if (!file.open(QIODevice::ReadOnly)) { return; } QJsonParseError err; QJsonDocument doc QJsonDocument::fromJson(file.readAll(), err); if (err.error ! QJsonParseError::NoError) { qWarning() JSON 解析失败: err.errorString() 偏移: err.offset; return; } QJsonObject root doc.object(); QString name root.value(name).toString(); int port root.value(port).toInt(8080); // 写入 QJsonObject obj; obj.insert(name, 设备A); obj.insert(port, 9000); QJsonDocument out(obj); QFile wf(config.json); if (wf.open(QIODevice::WriteOnly | QIODevice::Truncate)) { wf.write(out.toJson(QJsonDocument::Indented)); }toJson的Indented参数会让输出带缩进方便人工查看如果要传输就给Compact。解析时必须接QJsonParseError不然格式错了你只会拿到一个空对象排查半天。5. 常见问题与排查实录这一章是我自己真实遇到过、并且帮别人解决过的典型问题。按出现频率排序。5.1 模块缺失Unknown module(s) in QT: serialport这个报错的完整形式是Project ERROR: Unknown module(s) in QT: serialport出现的原因是你在.pro里写了QT serialport但安装的 Qt 里根本没这个模块。排查顺序是这样的打开 Qt 安装目录看D:\Qt\5.15.2\msvc2019_64\include下面有没有QtSerialPort文件夹。如果没有说明安装时没勾这个组件。不需要卸载重装重新运行 Qt 的安装程序或者维护工具选添加或移除组件展开对应 Qt 版本在 Additional Libraries 里勾上Qt Serial Port然后更新。如果文件夹存在但还是报错检查你在.pro里写的是不是serialport全小写大小写敏感。如果包里确实没有这个模块比如某些精简版也可以下载源码用 VS 自己编译qmakenmake走一遍生成对应的 lib 和 dll再把输出拷回 Qt 目录。同类问题会出现在charts、sql、multimedia、websockets、bluetooth上处理思路完全一致。所以写工程文件时我习惯在前面加一层保护qtHaveModule(serialport) { QT serialport DEFINES HAVE_SERIALPORT } else { message(未找到 SerialPort 模块相关功能将被禁用) }这样即使换了机器、换了 Qt 版本工程也不会因为缺模块直接崩掉对团队协作特别友好。5.2 编译能过运行报缺少 DLL现象是双击 exe 弹窗由于找不到 Qt5Core.dll无法继续执行代码或者更典型的This application failed to start because no Qt platform plugin could be initialized。前者是主库没找到后者是平台插件qwindows.dll没找到。第二个更隐蔽因为Qt5Core.dll你手动拷过去了程序能启动但一创建窗口就崩。根因很清楚Qt 的动态库默认不在 exe 旁边也不在系统 PATH 里。开发阶段最简单的做法是把D:\Qt\5.15.2\msvc2019_64\bin加到系统环境变量Path里但这只解决了开发机发布出去照样缺。发布必须走第 6 章的部署流程。还有一个容易忽略的点Debug 和 Release 的 DLL 不能混用。Debug 版程序要配Qt5Cored.dll带 d 后缀Release 版配Qt5Core.dll。曾经有人发布时把 Debug 目录整个拷出去在没装 VS 的机器上直接报缺VCRUNTIME140D.dll因为 Debug 运行时库是不能分发的。5.3 插件和缓存类报错用了 Qt VS Tools 之后可能碰到的几种打开解决方案提示 Qt 版本无效Qt 版本是在用户级配置里存的换电脑或者目录移动后路径失效。去Qt VS Tools → Qt Versions重新指向新的qmake.exe路径即可。修改了.pro文件但 VS 工程没跟着变Qt VS Tools 的 qmake 工程同步是手动触发的右键项目 →Qt → Refresh IntelliSense或者重新生成项目。moc 文件没更新改了代码行为没变清理方案是删除项目目录下的.vs隐藏文件夹、删除生成目录x64或Debug/Release然后重新生成。这是万能的重置手段九成诡异的构建问题都能这么解决。cannot open source file ui_xxx.huic 还没跑过。先生成解决方案一次让.ui被处理IntelliSense 就正常了。5.4 常见问题速查表现象大概率原因处理动作Unknown module(s) in QT: xxx模块未安装维护工具勾选 Additional LibrariesLNK2001 staticMetaObject头文件缺少 moc 项类型属性里设为 Qt Meta-Object Compiler找不到 Qt5Core.dll运行时库不在路径加 Path 或执行部署no Qt platform plugin缺 platforms 目录拷platforms/qwindows.dll中文乱码源文件编码与编译选项不一致加/utf-8统一 UTF-8qDebug 看不到输出输出被重定向看 VS 输出窗口或挂调试器换了 Qt 版本后编译报错工程还指向旧版本切换 Qt Version 并重新生成断点提示未加载符号未装调试符号文件安装 Qt Debug Information FilesVS 找不到 Qt 实例残留注册表用 Installer 重装别手动删6. 发布部署与后续扩展6.1 windeployqt一条命令搞定依赖收集Qt 自带一个部署工具windeployqt.exe它会扫描你的 exe把用到的 Qt DLL、平台插件、图片格式插件、翻译文件全拷到 exe 同级目录。cd /d D:\Build\MyApp\release D:\Qt\5.15.2\msvc2019_64\bin\windeployqt.exe --release --no-translations MyApp.exe参数说明--release指定按 Release 模式收集Debug 就用--debug--no-translations跳过翻译文件能省几 MB--qmldir dir是做 QML 项目时必须加的不加的话 QML 相关的插件不会被收集。跑完之后目录里会多出Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll、platforms/、styles/、imageformats/这些。platforms目录必须和 exe 同级不能塞进子文件夹这是 Qt 插件加载机制的硬性要求。最后一个坑Qt 的运行库还要依赖 MSVC 运行时vcruntime140.dll、msvcp140.dll。目标机器上如果没装过 VC 运行库就会报错。稳妥的做法是把Microsoft.VC143.CRT目录下的几个 dll 一起拷过去或者打包一个官方的 VC_redist 安装包一起发布。如果要做成单文件可以用 Enigma Virtual Box 把整个目录封成一个 exe或者用 NSIS/Inno Setup 做安装包。商业项目里我一般用 Inno Setup脚本简单、支持中文界面、能自动注册文件关联。6.2 这套环境能扩展出什么搭好这套基础环境之后往各个方向延伸都比较顺。接第三方算法 SDK。比如做机器视觉类的软件常见的做法是在 VS 工程属性页里加 SDK 的 include 和 lib 路径把运行时 dll 放到 exe 目录然后写一个封装类把 SDK 的 C 接口包成 Qt 友好的形式。因为 SDK 官方给的样例通常就是 VS 工程直接把它们搬进你的解决方案里对照调试比在别的 IDE 里折腾快得多。模拟鼠标点击、做自动化操作。Qt 层面可以用QTest::mouseClick做控件级模拟主要用于单元测试系统级模拟则用 Windows 的SendInput或mouse_event。要在自己进程内触发别的控件的事件也可以构造QMouseEvent之后用QCoreApplication::sendEvent直接派发同步执行不进事件队列。做窗口管理类的工具。分屏、贴边、多显示器管理这类需求处理思路是监听窗口消息WM_WINDOWPOSCHANGING、WM_GETMINMAXINFO计算目标矩形后用SetWindowPos调整。Qt 的QWidget::nativeEvent可以拦截到这些消息配合QScreen拿到多显示器的布局信息。Qt Console 程序做命令行工具。建工程时选Qt Console Application用QCommandLineParser解析参数比手写 argv 遍历规范得多还自带--help生成。QML 和 C 混合。界面用 QML 做流畅动画业务逻辑留在 C通过qmlRegisterType注册类型或者用QQmlContext::setContextProperty注入对象。这套在 VS 里也能跑Qt VS Tools 有对应的 Quick Application 模板。最后分享一个我用了很久的习惯每搭好一个新环境就立刻建一个环境自检工程里面只做四件事——弹一个窗口、写一个 JSON 文件、连一次串口或者 TCP、打一行中文日志。以后换电脑、升级 Qt、装新插件先跑这个工程五分钟就能确认环境有没有问题比在大项目里瞎猜快得多。这个习惯帮我省掉的时间保守估计得有一整个工作周。
