用 Visual Studio 写 QML很多人第一反应是“这不是 Qt Creator 的活吗”说实话放在几年前我也这么觉得。但当你手里拿着一套已经跑了很久的 Visual Studio C 解决方案或者团队基础设施全是 MSVC CMake VS 的时候你会发现把 QML 工程硬塞进 Qt Creator 反而割裂了工作流。Qt 官方其实早就给出了官方支持路径——通过 Qt VS Tools 扩展Visual Studio 2022 完全可以承担 QML 工程的创建、编辑、编译和调试工作而且跟原生 C 代码、调试器、版本控制、CI 集成的紧密程度是 Qt Creator 没法比的。这篇文章我会从零开始把整个流程拆开讲环境怎么装、扩展怎么配、工程怎么建、QML 编译链路是怎么回事、以及那些你一跑就会撞上的报错比如 qml 编译错误、插件路径不识别、环境变量没生效到底该怎么排查。全程基于 Qt 6.8.3 MSVC 2022 工具链实测所有步骤你照着做基本一遍过。1. 为什么要在 Visual Studio 里搞 QML1.1 QML 开发的传统阵营与 VS 的定位QML/Qt Quick 这套东西官方钦定的开发环境是 Qt Creator它自带设计态预览、QML 热重载、原型工具对纯 QML 项目来说体验确实顺滑。但现实中的 Qt 项目很少是纯 QML 的——大概率是 C 提供核心逻辑和底层接口QML 只负责界面层和交互层。这种混合架构落到工程层面就需要一个能同时管住 CMake 工程文件、C 编译、QML 资源打包、断点调试的统一 IDE。Visual Studio 在这个场景下的定位非常明确它不是一个 QML 专用编辑器而是整个工程的“总控台”。CMakePresets、MSBuild、调试器、代码分析、Git 集成这些东西是 VS 的强项Qt VS Tools 则补齐了 Qt 专属的那一块——包括工程模板、Qt 版本管理、qmake/CMake 转换、以及 QML 文件的语法高亮和智能感知。两者结合起来C 后端和 QML 前端可以在同一条流水线里编译、打包、部署不用在两个 IDE 之间来回切换。1.2 这套方案适合谁、能解决什么问题我梳理下来以下几种情况特别适合用 VS 来创建和管理 QML 工程第一种团队技术栈已经被 MSVC CMake 锁死的传统 C Windows 项目要新加一个 Qt Quick 界面模块。第二种项目用到了 Qt 不太方便做的 Windows 平台特性比如 DirectX 互操作、WinUI 混编、系统级 COM 调用这部分代码必须在 VS 里写。第三种你已经在用 Qt 6 的 MSVC 预编译包比如 6.8.3 msvc2022_64但不想为了 QML 单独再装一套 Qt Creator 工具链。这套方案解决的最核心问题是从“用 VS 写 C”到“用 VS 写整个 Qt 应用”的过渡断层。装好 Qt VS Tools 之后你可以直接 File New Project 里选 Qt 相关模板VS 会生成带 CMakeLists.txt 的新工程QML 文件会被自动识别为 Qt Quick 资源编译时走 qmlcachegen 和 qmllint 的流程运行和 F5 调试也都是无缝的。整个过程不需要切窗口不需要手写复杂配置对已经熟悉 VS 操作习惯的人来说学习成本很低。2. 环境准备Visual Studio 2022 Qt 6.8 Qt VS Tools2.1 安装 Qt SDK 时该选哪些组件先说结论QML 开发在 Windows 上的标准组合是 Qt 6.x MSVC 预编译包 Visual Studio 2022 的 C 工作负载。Qt 下载安装时官方安装器会让你勾选组件很多人图省事直接全选结果装完一堆用不到的模块还占了几十 GB 磁盘。实际上 QML 工程正常只需要以下几项Qt 6.8.x 下的MSVC 2022 64-bit预编译包对应你 VS 的版本比如msvc2022_64Qt Quick模块包含 QML 运行时、Quick 控件、渲染后端Qt Quick Controls 2如果你要用现成控件Qt Shader ToolsQML 场景图编译 shader 时需要Qt Debugger 与开发工具在 Tools 分类里选 Qt Creator 调试器相关组件VS 调试时会用到这里注意一个原则为你 VS 版本匹配的 msvc 前缀套件。比如你装的是 Visual Studio 2022就选msvc2022_64不要选msvc2019_64或mingw版本。Qt 6 的 MSVC 二进制和 VS 工具链有严格的 ABI 绑定交叉使用很容易在链接阶段爆出一堆“无法解析的外部符号”错误。安装完成后记好你的 Qt 安装根目录典型路径是D:\Qt\6.8.3\msvc2022_64。这个路径后面配置 Qt VS Tools 的时候要用建议直接用英文路径避免出现中文目录导致的 QML 模块加载异常。2.2 安装与配置 Qt VS Tools 扩展Qt VS Tools 是 Qt 官方出的 VS 扩展不是第三方插件支持 Visual Studio 2022。安装方式有两种第一种直接在 VS 里打开Extensions Manage Extensions搜索 “Qt Visual Studio Tools”找到官方扩展安装装完重启 VS。第二种从 Qt 官方下载页面单独下载.vsix安装包双击安装。这种方式适合公司内网环境或者 VS 扩展市场访问不顺畅的情况。装完之后VS 菜单栏会出现一个Extensions Qt VS Tools的子菜单。首次使用前必须先做一步配置 Qt 版本路径。路径是Extensions Qt VS Tools Qt Versions点Add按钮把 Qt 安装目录下的msvc2022_64指给它。VS 会扫描这个目录底下的bin/qmake.exe和 CMake 配置然后把它注册为当前可用的 Qt 版本。这里有一个实操小细节Qt VS Tools 的版本列表里一项配置是全局的多个解决方案共享。如果你同时装了 Qt 6.5、6.8 等多个版本每个都要添加进去但只有一个会被标记为“默认”。创建工程的时候VS 会根据解决方案配置选择对应的 Qt 包所以你在同一个 VS 实例里同时维护老版本 Qt 5.15 工程和新版 Qt 6.8 工程都是可以的互不干扰。2.3 设置 CMake 工作台与目标平台Qt 6 时代创建新工程官方推荐 CMake 而不是 qmake。VS 2022 对 CMake 的支持已经相当原生工程打开后VS 会自动读取顶层的CMakeLists.txt生成 CMake cache你不需要额外做什么。但有几个配置项最好先确认一下项目属性 配置属性 常规 C 语言标准Visual Studio 2022 默认可能给的是std:c14Qt 6 需要 C17 以上建议设为std:c17或std:clatest。配置管理器确认 Active Solution Platform 是 x64。Qt 预编译包基本是 x64 的Win32 平台会链接不上 Qt 库文件。CMake 生成器VS 2022 内置的 CMake 支持用的是 Ninja 生成器这是默认行为不需要手改。如果之前装过独立 CMakeVS 会优先用内置的避免版本混乱。这些配置不改的话最常见的现象是 CMakeConfigure 失败报错信息里出现Qt6_DIR或者CMAKE_PREFIX_PATH找不到。原因是 VS 的 CMake 集成不认识 Qt 的安装位置。解决方法是在 CMakeLists.txt 顶部加一行set(CMAKE_PREFIX_PATH D:/Qt/6.8.3/msvc2022_64)或者更干净的方式——通过 VS 的CMake 设置编辑器CmakeSettings.json指定CMAKE_PREFIX_PATH为缓存变量。我个人推荐后者因为不污染源代码。{ configurations: [ { name: x64-Debug, generator: Ninja, configurationType: Debug, cacheVariables: { CMAKE_PREFIX_PATH: D:/Qt/6.8.3/msvc2022_64 } } ] }3. 创建第一个 QML 工程从模板到跑起来3.1 用模板创建工程的完整操作配置齐了之后创建 QML 工程的路径非常直接打开 Visual Studio 2022选择File New Project。在创建新项目对话框顶部的搜索框输入Qt你会看到 Qt VS Tools 提供的几个模板Qt Widgets Application、Qt Quick Application、Qt Console Application等。选Qt Quick Application点击 Next。填写项目名称和存放位置比如项目名DemoQmlApp位置D:\workspace。点CreateVS 会弹出 Qt VS Tools 的向导页Qt Project Wizard让你选择使用 CMake 还是 qmake——选CMakeQt Quick 版本选 6.x然后 Finishing。模板生成出来的工程文件结构大致是这样DemoQmlApp/ ├── CMakeLists.txt ├── main.cpp ├── qml.qrc ├── qml/ │ └── Main.qml └── ...到这一步一个可编译的 QML 工程就创建出来了。别急着改代码先直接 CtrlShiftB 构建一次确认环境没问题。首次构建会跑 CMake configure速度取决于机器一般几十秒到几分钟。如果构建输出结尾出现Build succeeded说明你的工具链链路完全通了。3.2 工程结构拆解CMakeLists、main.cpp、main.qml 各管什么模板生成的文件不多但每个都值得说清楚因为后面所有 QML 工程都是在这个骨架上长出来的。CMakeLists.txt是工程的灵魂。Qt 6 的 CMake 写法跟 Qt 5 有明显区别模板生成的版本已经帮你写好了关键内容大概长这样cmake_minimum_required(VERSION 3.16) project(DemoQmlApp VERSION 0.1 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Qt6 REQUIRED COMPONENTS Quick) qt_standard_project_setup(REQUIRES 6.5) qt_add_executable(DemoQmlApp main.cpp) qt_add_qml_module(DemoQmlApp URI DemoQmlApp VERSION 1.0 QML_FILES qml/Main.qml ) target_link_libraries(DemoQmlApp PRIVATE Qt6::Quick)这里面最核心的是qt_add_qml_module()。这个函数会做几件事把列出来的 QML 文件注册成 Qt Quick 模块为它们生成对应的插件元数据qmldir如果 Qt 版本支持还会在构建时跑qmllint检查 QML 语法以及用qmlcachegen预编译 QML 到 C 缓存。QML 文件只要加到这个函数的QML_FILES参数里VS 的智能感知就能找到它们运行时也能通过qrc://或qml/路径正确加载。main.cpp负责启动 QML 运行时。模板生成的代码非常精简#include QGuiApplication #include QQmlApplicationEngine int main(int argc, char *argv[]) { QGuiApplication app(argc, argv); QQmlApplicationEngine engine; engine.loadFromModule(DemoQmlApp, Main); return app.exec(); }engine.loadFromModule()这种写法是 Qt 6 新增的模块加载方式替代了 Qt 5 时代拿字符串路径去engine.load(qrc:/qml/Main.qml)的老路子。它的好处是加载时走的是模块寻址逻辑能自动处理 QML 模块内的依赖关系和插件的 import而不是表面上的文件路径。所以如果你想新加一个 QML 页面直接把文件名加进 CMakeLists 的QML_FILES里页面里用import DemoQmlApp就能互相引用。Main.qml就是界面层了模板里是一个简单的窗口加一个文本。这个文件能满足所有 QML 调试需求修改后热重载需要开 QML debugger、断点调试、表达式求值都从这个文件开始。3.3 构建、运行与调试的完整流程工程创建好后日常开发流程是这样跑的构建CtrlShiftB或者 Debug Build Solution。VS 会依次执行 CMake configure、qmlcachegen、C 编译、链接。如果 QML 文件里写了非法语法qmllint 会在编译阶段直接报错这比运行时弹黑窗要好排查得多。运行CtrlF5。VS 会直接启动编译生成的 .exe。Qt 模块依赖通过 Qt VS Tools 写入的 PATH 自动处理理论上不会出现缺 DLL 的提示。调试F5。要点是必须在 QML 调试器开启的状态下断点才能命中 QML 行。默认模板会把QML_DEBUG相关宏加进编译选项所以 F5 直接就能调。在 QML 文件行号左边点一下设置断点跑起来之后VS 的 Debug Windows Locals 里能查看 QML 对象的属性值跟 C 侧混排调试没有障碍。我第一次在 VS 里调 QML 时最不习惯的一点是QML 断点命中的瞬间调用栈里会混着引擎内部的 C 帧一堆QQuickWindowPrivate、QQmlEngine之类的东西。别被吓到正常情况你看最顶上的几帧就行那个标着.qml源文件位置的帧就是你自己代码的执行点。4. 核心细节解析QML 工程的编译、导入与运行原理4.1 QML 的三种执行模式与编译链路很多人刚开始搞 QML 会有一个疑问QML 到底是解释执行还是编译执行答案是两种情况都有取决于你怎么部署。第一种是原始解释模式纯文本.qml文件被 QQmlEngine 在运行时直接解析遇到错误才报出来。开发调试时最常用改一行刷新就能看到效果。第二种是通过qmlcachegen 预编译构建时把 QML 转成中间缓存格式或直接转成 C 源码编译进二进制运行时加载速度明显变快。Qt 6 的qt_add_qml_module()默认就会启用这个优化你打开构建输出能看到qmlcachegen那一行。第三种是AOT 编译到 C通过qt_add_qml_module()配合指定选项QML 类型会被映射为 C 类构建产物里直接包含编译后的代码。这种模式下 QML 文件基本“消失”了适合对启动性能要求极高的嵌入式场景。这三种模式对日常开发最直接的影响就是你会看到不同的报错形式。解释模式下 QML 语法错误要到运行那一刻才爆但 qmlcachegen 模式下语法错误在构建期就会被拦下来。所以当你看到构建输出里有qmlcachegen相关的 error 时说明你的 QML 文件里存在语法级问题先修这个别急着去跑程序。4.2 导入路径与 QML_IMPORT_PATH 环境变量QML 的import机制跟 C 的#include感觉类似但底层是另一套逻辑。QML 引擎在解析import QtQuick.Controls时会往 QML 导入路径里查找对应的模块目录找到之后读取模块里的qmldir文件才知道这个模块导出了哪些类型、需要加载哪些插件。Qt 自带的模块比如QtQuick、QtQuick.Controls、QtQuick.Layouts它们的安装目录里都自带 qmldir引擎默认能识别。真正容易出问题的是你自己的模块或者第三方模块。如果你的 QML 文件里写了类似import MyCustomControls的语句但引擎报“module not found”十有八九是导入路径没设对。排查顺序如下确认模块目录下有没有qmldir文件没有的话 Qt 不认为这是个模块。确认qmldir里的plugin关键字指向的动态库文件名正确后缀和平台相关Windows 上通常是.dll。在运行入口处打印engine.importPathList()看当前实际生效的导入路径有哪些。QQmlApplicationEngine engine; auto paths engine.importPathList(); for (const auto p : paths) { qDebug() QML import path: p; }环境变量这块Qt 6 继承并扩展了 Qt 5 的设置逻辑。开发调试直接设置用户环境变量也行VS 里也能针对调试会话临时指定QML_IMPORT_PATHQt 6 主推的导入路径变量分号分隔多个路径。QML2_IMPORT_PATHQt 5/6 兼容遗留变量某些老模块还在读。如果你在 VS 里跑 QML 工程时经常出现自定义模块找不到我建议先在系统环境变量里把QML_IMPORT_PATH指到自定义模块的父目录一劳永逸。设置完之后记得重启 Visual Studio因为 VS 的环境变量缓存是启动时读取的重启前改了不生效这个问题我踩过不止一次。4.3 资源和模块化管理qmldir、QML modules 与插件一个正经的 QML 工程随着界面变复杂QML 文件会越来越多。全部堆在同一个目录下很快会乱这时就要靠模块化管理。Qt 6 推荐的模块化方式是每个功能域建一个目录目录里放一个qmldir文件。qmldir的语法很简单一个典型例子module MyApp.Controls singleton Theme 1.0 Theme.qml Button 1.0 Button.qml这个文件声明了本模块导出的类型名称、版本、以及对应的 QML 文件或 C 插件。qmlcachegen 在构建时也会读取它所以模块内的类型互相引用非常自然。在 Visual Studio 里模块化管理的操作无非就是在工程里新建若干目录把 QML 文件分门别类放好然后在 CMakeLists 的qt_add_qml_module()里把子目录的路径加进QML_FILES或者在RESOURCES参数里把整个目录加进去。VS 的解决方案资源管理器能直接看到这些目录结构拖拽调整位置后CMake 重新配置一下就能识别新路径。特别提醒一个坑QML 模块的 URI 要和目录结构对应。比如URI MyApp.Controls那么导入时写import MyApp.Controls引擎会跳到导入路径下的MyApp/Controls目录里找 qmldir。如果你的目录层级和 URI 对不上构建可能没问题但运行时报 module not found 的概率极其高。5. 常见问题与排查技巧实录5.1 QML 编译错误qmlcachegen 与 qmllint 的报错怎么读QML 编译错误是每个人都会撞上的第一道坎报错位置不同处理方法完全不同。第一种是qmllint的语法/语义错误。这种错误会明确标出文件路径和行号比如“unexpected token”、“Cannot assign to non-existent property”。看到这类报错打开对应的 QML 文件去那一行附近找语法问题基本是拼写、花括号、逗号这类低级错误。qmllint 是 Qt 6.5 以后默认启用的好处是很多运行时才暴露的问题能提前在编译期拦住。第二种是qmlcachegen的报错特征是输出里出现required property was not found、cannot generate code这类字样。这类错误常见于 QML 文件里用了条件导入、动态类型创建或者某些写法编译器拿不准。处理方案一般是要么在你 QML 里去掉那种过于动态的写法改成静态可分析的类型引用要么在qt_add_qml_module()里把出问题的那个文件对 qmlcachegen 做豁免。具体做法是在QML_FILES旁边加一行QML_CACHEGEN_OPTIONS或者干脆把文件挪到非编译资源里用RESOURCES加载。第三种是比较隐晦的运行时 QML 错误。构建全绿F5 一跑程序起来黑屏或者白屏输出窗口里有一堆QQmlComponent: Component is not ready之类的日志。这种情况老老实实看 QML 引擎输出的错误详情里面通常会带 qrc 路径和具体错误说明。别瞎猜90% 是某个 qml 文件引用了不存在的 id 或属性。5.2 插件加载失败与 Quick Studio Components 路径问题这个问题的经典报错长这样“plugin ... could not be loaded”或者“module ... is not installed”后面跟着一长串完整路径比如plugin d:/qt/qt/6.8.3/msvc2022_64/qml/qtquick/studio/components/quickstudio...你一看路径就知道 Qt 在尝试加载某个插件但加载失败了。这种失败的原因总结下来就三类第一类插件依赖的 DLL 缺失。Qt Quick Studio Components 这类模块依赖一些额外的运行时库如果 Qt 安装时没选对应组件插件目录里就缺东西。解决办法不是去网上随便下 DLL而是回到 Qt 安装器把缺的模块补装上。第二类运行时 PATH 没包含 Qt 的 bin 目录。VS 里跑 Qt 程序时Qt VS Tools 会自动配置 PATH但你有的是办法把它搞坏——比如改了系统 PATH或者用别的启动方式。排查方法是在 VS 里打开项目属性看调试配置里 PATH 那条变量有没有包含D:\Qt\6.8.3\msvc2022_64\bin。第三类模块元数据和实际文件对不上比如 qmldir 里声明的插件文件名和实际 dll 名称不一致多见于手工拷贝 Qt 模块到别的地方的情况。这种问题优先看qmldir文件内容确认plugin字段指向的文件名是否正确。这里有个比较实用的验证技巧设置好路径后在 QML 文件里加一行 import 目标模块然后编译运行。如果模块加载成功程序正常显示如果还是失败再用windeployqt工具看看部署日志里有没有明确写到哪个库缺失。5.3 VS Installer 服务不可用等环境级故障常逛社区的朋友应该见过这个问题Visual Studio Installer 打开时报“Windows Installer 服务不可用请重启系统”。这句话听起来很吓人但实际上多半不是 Windows Installer 服务本身坏了而是 VS Installer 的独立进程启动时依赖的某个 Windows 服务被禁用或者异常终止。我还真碰到过一次是在一次系统优化之后某些“一键清理”工具会禁掉一堆服务。排查步骤是按 WinR输入services.msc找到Windows Installer服务确认状态是“正在运行”启动类型是“手动”。如果没运行右键启动。如果启动失败检查事件查看器里的错误日志常见原因是权限或依赖服务没起来。实在不行用管理员权限的命令提示符执行msiexec /unregister然后msiexec /regserver强制重新注册 Windows Installer。这个服务修好之后VS Installer 基本就能正常打开了。如果你遇到的是 VS Installer 其他模块的问题比如“安装程序检测到当前正在运行的其他 VS 实例”那检查后台有没有 devenv.exe 或 vs_installer 进程残留全杀掉再重试。这种事虽然不是 QML 工程本身的报错但它挂在“VS 里跑 QML”这条链路上跑顺了就是一次性的跑不顺能把人卡一上午。我是建议先把这一步处理干净再折腾扩展和 Qt 包不然扩展装不上后面啥都白搭。5.4 调试器无法附加、断点不生效QML 断点不生效是比编译错误更让人挠头的问题。明明在 Main.qml 第 20 行打了断点F5 跑起来界面正常显示了但断点就是不命中变成一个空心圆。我排查下来原因基本逃不开以下几点第一构建配置是 Release。Release 模式下 qmlcachegen 会做激进优化QML 文件的源码位置信息和调试符号可能被剥离断点自然命中不了。切到 Debug 配置重新构建再看断点。第二QML 调试没有启用。Qt 6 里QML 调试验证需要条件编译宏来开启调试服务器。VS 的 Qt VS Tools 在 Debug 配置下会自动加但你如果手改过 CMakeLists 里的编译选项可能把它关了。检查 CMake 配置或者直接看启动参数里有没有-qmljsdebuggerport:...之类的字眼。第三运行的不是当前构建的 exe。这个属于操作问题有时你 F5 调试的路径指向的是别处拷贝的旧版本 exe代码和二进制完全对不上。确认项目属性里调试命令指向的是 build 输出目录里的新 exe。第四QML 文件被多次加载。如果你用engine.loadFromModule又从qrc:/加载了同名 QML引擎里存在多份组件实例断点可能命中的是另一份。这种排查起来麻烦但可以通过在构造函数或 onCompleted 里打个 qDebug 看加载的是哪份资源。5.5 QML 的导入环境变量设置关于QML_IMPORT_PATH的设置上面在原理部分已经讲了机制这里专门给一个具体的操作指南因为这块踩坑率极高。在 Windows 上如果你用 Visual Studio 开发设置这个环境变量的入口有系统级Windows 设置 系统 关于 高级系统设置 环境变量 新建。变量名QML_IMPORT_PATH值是自定义模块父目录多个路径用分号分隔。设完之后必须重启 Visual Studio。调试会话级VS 项目属性 调试 环境填入QML_IMPORT_PATHD:\path\to\your\modules。这个只对当前项目的调试会话生效不需要重启系统改完直接 F5 就带上。代码级在 main.cpp 里QQmlApplicationEngine engine;之后立即调用engine.addImportPath(D:/path/to/your/modules);。这个最灵活也是我推荐的生产环境做法因为它跟部署环境绑定不会因为开发机没配环境变量就挂。这三个层级从粗到细优先级也是代码级最高。如果你三个地方都设置了以代码级为准。实际项目里我一般开发阶段用调试会话级发布阶段在代码里硬编码相对路径相对 exe 目录的模块路径这样部署到别的机器上不会出现路径失效的问题。6. 这套流程在日常项目里的扩展与取舍写到这里Visual Studio 里创建 QML 工程的主流程基本走完了。最后聊点个人经验和这套方案的边界方便你决定是否真的要把日常开发迁到 VS 上。对于 C 和 QML 混合型项目VS 的体验确实比 Qt Creator 更顺手尤其是涉及到跨模块重构、符号查找、性能分析这些场景。QML 文件在 VS 里默认没有设计器预览纯 QML 界面调整时会觉得不如 Qt Creator 直观但 Vs 里装一个 Qt Quick 设计器扩展可以缓解或者开发时在 VS 里写逻辑、用 Qt Creator 双开看设计效果。我团队里现在就是这么分工的写代码和调试走 VS看视觉效果开 Creator 预览两边各取其长。新工程模板这块Qt VS Tools 生成的是比较基础的骨架。如果项目要上 QML 国际化lupdate/lrelease、qmldir 多模块管理、或者接入 Qt 的单元测试建议直接在 CMakeLists 里扩展不要指望模板全部生成好。VS 的 CMake 集成对增量修改的响应非常快改完 CMakeLists 保存一下VS 会自动重新 configure基本不需要手动点。最后提醒一下版本匹配Qt 6.8 对应 VS 2022 17.8Qt 6.9 要求 VS 2022 17.12。低版本 VS 配高版本 Qt 的 MSVC 包编译期会报“_MSC_VER 版本不匹配”或者干脆一堆头文件编译失败。如果你公司电脑的 VS 版本比较旧就老老实实装对应年份的 Qt 预编译包别为了追新把工具链搞得四不像。这套东西配置好一次之后后续创建新工程都是几分钟的事真正花时间的反而是那些环境级问题的排查——这也是我写这篇文章的原因希望你能绕开我踩过的这些坑。
Visual Studio 2022 中创建与调试 QML 工程：Qt VS Tools 完整实践指南
用 Visual Studio 写 QML很多人第一反应是“这不是 Qt Creator 的活吗”说实话放在几年前我也这么觉得。但当你手里拿着一套已经跑了很久的 Visual Studio C 解决方案或者团队基础设施全是 MSVC CMake VS 的时候你会发现把 QML 工程硬塞进 Qt Creator 反而割裂了工作流。Qt 官方其实早就给出了官方支持路径——通过 Qt VS Tools 扩展Visual Studio 2022 完全可以承担 QML 工程的创建、编辑、编译和调试工作而且跟原生 C 代码、调试器、版本控制、CI 集成的紧密程度是 Qt Creator 没法比的。这篇文章我会从零开始把整个流程拆开讲环境怎么装、扩展怎么配、工程怎么建、QML 编译链路是怎么回事、以及那些你一跑就会撞上的报错比如 qml 编译错误、插件路径不识别、环境变量没生效到底该怎么排查。全程基于 Qt 6.8.3 MSVC 2022 工具链实测所有步骤你照着做基本一遍过。1. 为什么要在 Visual Studio 里搞 QML1.1 QML 开发的传统阵营与 VS 的定位QML/Qt Quick 这套东西官方钦定的开发环境是 Qt Creator它自带设计态预览、QML 热重载、原型工具对纯 QML 项目来说体验确实顺滑。但现实中的 Qt 项目很少是纯 QML 的——大概率是 C 提供核心逻辑和底层接口QML 只负责界面层和交互层。这种混合架构落到工程层面就需要一个能同时管住 CMake 工程文件、C 编译、QML 资源打包、断点调试的统一 IDE。Visual Studio 在这个场景下的定位非常明确它不是一个 QML 专用编辑器而是整个工程的“总控台”。CMakePresets、MSBuild、调试器、代码分析、Git 集成这些东西是 VS 的强项Qt VS Tools 则补齐了 Qt 专属的那一块——包括工程模板、Qt 版本管理、qmake/CMake 转换、以及 QML 文件的语法高亮和智能感知。两者结合起来C 后端和 QML 前端可以在同一条流水线里编译、打包、部署不用在两个 IDE 之间来回切换。1.2 这套方案适合谁、能解决什么问题我梳理下来以下几种情况特别适合用 VS 来创建和管理 QML 工程第一种团队技术栈已经被 MSVC CMake 锁死的传统 C Windows 项目要新加一个 Qt Quick 界面模块。第二种项目用到了 Qt 不太方便做的 Windows 平台特性比如 DirectX 互操作、WinUI 混编、系统级 COM 调用这部分代码必须在 VS 里写。第三种你已经在用 Qt 6 的 MSVC 预编译包比如 6.8.3 msvc2022_64但不想为了 QML 单独再装一套 Qt Creator 工具链。这套方案解决的最核心问题是从“用 VS 写 C”到“用 VS 写整个 Qt 应用”的过渡断层。装好 Qt VS Tools 之后你可以直接 File New Project 里选 Qt 相关模板VS 会生成带 CMakeLists.txt 的新工程QML 文件会被自动识别为 Qt Quick 资源编译时走 qmlcachegen 和 qmllint 的流程运行和 F5 调试也都是无缝的。整个过程不需要切窗口不需要手写复杂配置对已经熟悉 VS 操作习惯的人来说学习成本很低。2. 环境准备Visual Studio 2022 Qt 6.8 Qt VS Tools2.1 安装 Qt SDK 时该选哪些组件先说结论QML 开发在 Windows 上的标准组合是 Qt 6.x MSVC 预编译包 Visual Studio 2022 的 C 工作负载。Qt 下载安装时官方安装器会让你勾选组件很多人图省事直接全选结果装完一堆用不到的模块还占了几十 GB 磁盘。实际上 QML 工程正常只需要以下几项Qt 6.8.x 下的MSVC 2022 64-bit预编译包对应你 VS 的版本比如msvc2022_64Qt Quick模块包含 QML 运行时、Quick 控件、渲染后端Qt Quick Controls 2如果你要用现成控件Qt Shader ToolsQML 场景图编译 shader 时需要Qt Debugger 与开发工具在 Tools 分类里选 Qt Creator 调试器相关组件VS 调试时会用到这里注意一个原则为你 VS 版本匹配的 msvc 前缀套件。比如你装的是 Visual Studio 2022就选msvc2022_64不要选msvc2019_64或mingw版本。Qt 6 的 MSVC 二进制和 VS 工具链有严格的 ABI 绑定交叉使用很容易在链接阶段爆出一堆“无法解析的外部符号”错误。安装完成后记好你的 Qt 安装根目录典型路径是D:\Qt\6.8.3\msvc2022_64。这个路径后面配置 Qt VS Tools 的时候要用建议直接用英文路径避免出现中文目录导致的 QML 模块加载异常。2.2 安装与配置 Qt VS Tools 扩展Qt VS Tools 是 Qt 官方出的 VS 扩展不是第三方插件支持 Visual Studio 2022。安装方式有两种第一种直接在 VS 里打开Extensions Manage Extensions搜索 “Qt Visual Studio Tools”找到官方扩展安装装完重启 VS。第二种从 Qt 官方下载页面单独下载.vsix安装包双击安装。这种方式适合公司内网环境或者 VS 扩展市场访问不顺畅的情况。装完之后VS 菜单栏会出现一个Extensions Qt VS Tools的子菜单。首次使用前必须先做一步配置 Qt 版本路径。路径是Extensions Qt VS Tools Qt Versions点Add按钮把 Qt 安装目录下的msvc2022_64指给它。VS 会扫描这个目录底下的bin/qmake.exe和 CMake 配置然后把它注册为当前可用的 Qt 版本。这里有一个实操小细节Qt VS Tools 的版本列表里一项配置是全局的多个解决方案共享。如果你同时装了 Qt 6.5、6.8 等多个版本每个都要添加进去但只有一个会被标记为“默认”。创建工程的时候VS 会根据解决方案配置选择对应的 Qt 包所以你在同一个 VS 实例里同时维护老版本 Qt 5.15 工程和新版 Qt 6.8 工程都是可以的互不干扰。2.3 设置 CMake 工作台与目标平台Qt 6 时代创建新工程官方推荐 CMake 而不是 qmake。VS 2022 对 CMake 的支持已经相当原生工程打开后VS 会自动读取顶层的CMakeLists.txt生成 CMake cache你不需要额外做什么。但有几个配置项最好先确认一下项目属性 配置属性 常规 C 语言标准Visual Studio 2022 默认可能给的是std:c14Qt 6 需要 C17 以上建议设为std:c17或std:clatest。配置管理器确认 Active Solution Platform 是 x64。Qt 预编译包基本是 x64 的Win32 平台会链接不上 Qt 库文件。CMake 生成器VS 2022 内置的 CMake 支持用的是 Ninja 生成器这是默认行为不需要手改。如果之前装过独立 CMakeVS 会优先用内置的避免版本混乱。这些配置不改的话最常见的现象是 CMakeConfigure 失败报错信息里出现Qt6_DIR或者CMAKE_PREFIX_PATH找不到。原因是 VS 的 CMake 集成不认识 Qt 的安装位置。解决方法是在 CMakeLists.txt 顶部加一行set(CMAKE_PREFIX_PATH D:/Qt/6.8.3/msvc2022_64)或者更干净的方式——通过 VS 的CMake 设置编辑器CmakeSettings.json指定CMAKE_PREFIX_PATH为缓存变量。我个人推荐后者因为不污染源代码。{ configurations: [ { name: x64-Debug, generator: Ninja, configurationType: Debug, cacheVariables: { CMAKE_PREFIX_PATH: D:/Qt/6.8.3/msvc2022_64 } } ] }3. 创建第一个 QML 工程从模板到跑起来3.1 用模板创建工程的完整操作配置齐了之后创建 QML 工程的路径非常直接打开 Visual Studio 2022选择File New Project。在创建新项目对话框顶部的搜索框输入Qt你会看到 Qt VS Tools 提供的几个模板Qt Widgets Application、Qt Quick Application、Qt Console Application等。选Qt Quick Application点击 Next。填写项目名称和存放位置比如项目名DemoQmlApp位置D:\workspace。点CreateVS 会弹出 Qt VS Tools 的向导页Qt Project Wizard让你选择使用 CMake 还是 qmake——选CMakeQt Quick 版本选 6.x然后 Finishing。模板生成出来的工程文件结构大致是这样DemoQmlApp/ ├── CMakeLists.txt ├── main.cpp ├── qml.qrc ├── qml/ │ └── Main.qml └── ...到这一步一个可编译的 QML 工程就创建出来了。别急着改代码先直接 CtrlShiftB 构建一次确认环境没问题。首次构建会跑 CMake configure速度取决于机器一般几十秒到几分钟。如果构建输出结尾出现Build succeeded说明你的工具链链路完全通了。3.2 工程结构拆解CMakeLists、main.cpp、main.qml 各管什么模板生成的文件不多但每个都值得说清楚因为后面所有 QML 工程都是在这个骨架上长出来的。CMakeLists.txt是工程的灵魂。Qt 6 的 CMake 写法跟 Qt 5 有明显区别模板生成的版本已经帮你写好了关键内容大概长这样cmake_minimum_required(VERSION 3.16) project(DemoQmlApp VERSION 0.1 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Qt6 REQUIRED COMPONENTS Quick) qt_standard_project_setup(REQUIRES 6.5) qt_add_executable(DemoQmlApp main.cpp) qt_add_qml_module(DemoQmlApp URI DemoQmlApp VERSION 1.0 QML_FILES qml/Main.qml ) target_link_libraries(DemoQmlApp PRIVATE Qt6::Quick)这里面最核心的是qt_add_qml_module()。这个函数会做几件事把列出来的 QML 文件注册成 Qt Quick 模块为它们生成对应的插件元数据qmldir如果 Qt 版本支持还会在构建时跑qmllint检查 QML 语法以及用qmlcachegen预编译 QML 到 C 缓存。QML 文件只要加到这个函数的QML_FILES参数里VS 的智能感知就能找到它们运行时也能通过qrc://或qml/路径正确加载。main.cpp负责启动 QML 运行时。模板生成的代码非常精简#include QGuiApplication #include QQmlApplicationEngine int main(int argc, char *argv[]) { QGuiApplication app(argc, argv); QQmlApplicationEngine engine; engine.loadFromModule(DemoQmlApp, Main); return app.exec(); }engine.loadFromModule()这种写法是 Qt 6 新增的模块加载方式替代了 Qt 5 时代拿字符串路径去engine.load(qrc:/qml/Main.qml)的老路子。它的好处是加载时走的是模块寻址逻辑能自动处理 QML 模块内的依赖关系和插件的 import而不是表面上的文件路径。所以如果你想新加一个 QML 页面直接把文件名加进 CMakeLists 的QML_FILES里页面里用import DemoQmlApp就能互相引用。Main.qml就是界面层了模板里是一个简单的窗口加一个文本。这个文件能满足所有 QML 调试需求修改后热重载需要开 QML debugger、断点调试、表达式求值都从这个文件开始。3.3 构建、运行与调试的完整流程工程创建好后日常开发流程是这样跑的构建CtrlShiftB或者 Debug Build Solution。VS 会依次执行 CMake configure、qmlcachegen、C 编译、链接。如果 QML 文件里写了非法语法qmllint 会在编译阶段直接报错这比运行时弹黑窗要好排查得多。运行CtrlF5。VS 会直接启动编译生成的 .exe。Qt 模块依赖通过 Qt VS Tools 写入的 PATH 自动处理理论上不会出现缺 DLL 的提示。调试F5。要点是必须在 QML 调试器开启的状态下断点才能命中 QML 行。默认模板会把QML_DEBUG相关宏加进编译选项所以 F5 直接就能调。在 QML 文件行号左边点一下设置断点跑起来之后VS 的 Debug Windows Locals 里能查看 QML 对象的属性值跟 C 侧混排调试没有障碍。我第一次在 VS 里调 QML 时最不习惯的一点是QML 断点命中的瞬间调用栈里会混着引擎内部的 C 帧一堆QQuickWindowPrivate、QQmlEngine之类的东西。别被吓到正常情况你看最顶上的几帧就行那个标着.qml源文件位置的帧就是你自己代码的执行点。4. 核心细节解析QML 工程的编译、导入与运行原理4.1 QML 的三种执行模式与编译链路很多人刚开始搞 QML 会有一个疑问QML 到底是解释执行还是编译执行答案是两种情况都有取决于你怎么部署。第一种是原始解释模式纯文本.qml文件被 QQmlEngine 在运行时直接解析遇到错误才报出来。开发调试时最常用改一行刷新就能看到效果。第二种是通过qmlcachegen 预编译构建时把 QML 转成中间缓存格式或直接转成 C 源码编译进二进制运行时加载速度明显变快。Qt 6 的qt_add_qml_module()默认就会启用这个优化你打开构建输出能看到qmlcachegen那一行。第三种是AOT 编译到 C通过qt_add_qml_module()配合指定选项QML 类型会被映射为 C 类构建产物里直接包含编译后的代码。这种模式下 QML 文件基本“消失”了适合对启动性能要求极高的嵌入式场景。这三种模式对日常开发最直接的影响就是你会看到不同的报错形式。解释模式下 QML 语法错误要到运行那一刻才爆但 qmlcachegen 模式下语法错误在构建期就会被拦下来。所以当你看到构建输出里有qmlcachegen相关的 error 时说明你的 QML 文件里存在语法级问题先修这个别急着去跑程序。4.2 导入路径与 QML_IMPORT_PATH 环境变量QML 的import机制跟 C 的#include感觉类似但底层是另一套逻辑。QML 引擎在解析import QtQuick.Controls时会往 QML 导入路径里查找对应的模块目录找到之后读取模块里的qmldir文件才知道这个模块导出了哪些类型、需要加载哪些插件。Qt 自带的模块比如QtQuick、QtQuick.Controls、QtQuick.Layouts它们的安装目录里都自带 qmldir引擎默认能识别。真正容易出问题的是你自己的模块或者第三方模块。如果你的 QML 文件里写了类似import MyCustomControls的语句但引擎报“module not found”十有八九是导入路径没设对。排查顺序如下确认模块目录下有没有qmldir文件没有的话 Qt 不认为这是个模块。确认qmldir里的plugin关键字指向的动态库文件名正确后缀和平台相关Windows 上通常是.dll。在运行入口处打印engine.importPathList()看当前实际生效的导入路径有哪些。QQmlApplicationEngine engine; auto paths engine.importPathList(); for (const auto p : paths) { qDebug() QML import path: p; }环境变量这块Qt 6 继承并扩展了 Qt 5 的设置逻辑。开发调试直接设置用户环境变量也行VS 里也能针对调试会话临时指定QML_IMPORT_PATHQt 6 主推的导入路径变量分号分隔多个路径。QML2_IMPORT_PATHQt 5/6 兼容遗留变量某些老模块还在读。如果你在 VS 里跑 QML 工程时经常出现自定义模块找不到我建议先在系统环境变量里把QML_IMPORT_PATH指到自定义模块的父目录一劳永逸。设置完之后记得重启 Visual Studio因为 VS 的环境变量缓存是启动时读取的重启前改了不生效这个问题我踩过不止一次。4.3 资源和模块化管理qmldir、QML modules 与插件一个正经的 QML 工程随着界面变复杂QML 文件会越来越多。全部堆在同一个目录下很快会乱这时就要靠模块化管理。Qt 6 推荐的模块化方式是每个功能域建一个目录目录里放一个qmldir文件。qmldir的语法很简单一个典型例子module MyApp.Controls singleton Theme 1.0 Theme.qml Button 1.0 Button.qml这个文件声明了本模块导出的类型名称、版本、以及对应的 QML 文件或 C 插件。qmlcachegen 在构建时也会读取它所以模块内的类型互相引用非常自然。在 Visual Studio 里模块化管理的操作无非就是在工程里新建若干目录把 QML 文件分门别类放好然后在 CMakeLists 的qt_add_qml_module()里把子目录的路径加进QML_FILES或者在RESOURCES参数里把整个目录加进去。VS 的解决方案资源管理器能直接看到这些目录结构拖拽调整位置后CMake 重新配置一下就能识别新路径。特别提醒一个坑QML 模块的 URI 要和目录结构对应。比如URI MyApp.Controls那么导入时写import MyApp.Controls引擎会跳到导入路径下的MyApp/Controls目录里找 qmldir。如果你的目录层级和 URI 对不上构建可能没问题但运行时报 module not found 的概率极其高。5. 常见问题与排查技巧实录5.1 QML 编译错误qmlcachegen 与 qmllint 的报错怎么读QML 编译错误是每个人都会撞上的第一道坎报错位置不同处理方法完全不同。第一种是qmllint的语法/语义错误。这种错误会明确标出文件路径和行号比如“unexpected token”、“Cannot assign to non-existent property”。看到这类报错打开对应的 QML 文件去那一行附近找语法问题基本是拼写、花括号、逗号这类低级错误。qmllint 是 Qt 6.5 以后默认启用的好处是很多运行时才暴露的问题能提前在编译期拦住。第二种是qmlcachegen的报错特征是输出里出现required property was not found、cannot generate code这类字样。这类错误常见于 QML 文件里用了条件导入、动态类型创建或者某些写法编译器拿不准。处理方案一般是要么在你 QML 里去掉那种过于动态的写法改成静态可分析的类型引用要么在qt_add_qml_module()里把出问题的那个文件对 qmlcachegen 做豁免。具体做法是在QML_FILES旁边加一行QML_CACHEGEN_OPTIONS或者干脆把文件挪到非编译资源里用RESOURCES加载。第三种是比较隐晦的运行时 QML 错误。构建全绿F5 一跑程序起来黑屏或者白屏输出窗口里有一堆QQmlComponent: Component is not ready之类的日志。这种情况老老实实看 QML 引擎输出的错误详情里面通常会带 qrc 路径和具体错误说明。别瞎猜90% 是某个 qml 文件引用了不存在的 id 或属性。5.2 插件加载失败与 Quick Studio Components 路径问题这个问题的经典报错长这样“plugin ... could not be loaded”或者“module ... is not installed”后面跟着一长串完整路径比如plugin d:/qt/qt/6.8.3/msvc2022_64/qml/qtquick/studio/components/quickstudio...你一看路径就知道 Qt 在尝试加载某个插件但加载失败了。这种失败的原因总结下来就三类第一类插件依赖的 DLL 缺失。Qt Quick Studio Components 这类模块依赖一些额外的运行时库如果 Qt 安装时没选对应组件插件目录里就缺东西。解决办法不是去网上随便下 DLL而是回到 Qt 安装器把缺的模块补装上。第二类运行时 PATH 没包含 Qt 的 bin 目录。VS 里跑 Qt 程序时Qt VS Tools 会自动配置 PATH但你有的是办法把它搞坏——比如改了系统 PATH或者用别的启动方式。排查方法是在 VS 里打开项目属性看调试配置里 PATH 那条变量有没有包含D:\Qt\6.8.3\msvc2022_64\bin。第三类模块元数据和实际文件对不上比如 qmldir 里声明的插件文件名和实际 dll 名称不一致多见于手工拷贝 Qt 模块到别的地方的情况。这种问题优先看qmldir文件内容确认plugin字段指向的文件名是否正确。这里有个比较实用的验证技巧设置好路径后在 QML 文件里加一行 import 目标模块然后编译运行。如果模块加载成功程序正常显示如果还是失败再用windeployqt工具看看部署日志里有没有明确写到哪个库缺失。5.3 VS Installer 服务不可用等环境级故障常逛社区的朋友应该见过这个问题Visual Studio Installer 打开时报“Windows Installer 服务不可用请重启系统”。这句话听起来很吓人但实际上多半不是 Windows Installer 服务本身坏了而是 VS Installer 的独立进程启动时依赖的某个 Windows 服务被禁用或者异常终止。我还真碰到过一次是在一次系统优化之后某些“一键清理”工具会禁掉一堆服务。排查步骤是按 WinR输入services.msc找到Windows Installer服务确认状态是“正在运行”启动类型是“手动”。如果没运行右键启动。如果启动失败检查事件查看器里的错误日志常见原因是权限或依赖服务没起来。实在不行用管理员权限的命令提示符执行msiexec /unregister然后msiexec /regserver强制重新注册 Windows Installer。这个服务修好之后VS Installer 基本就能正常打开了。如果你遇到的是 VS Installer 其他模块的问题比如“安装程序检测到当前正在运行的其他 VS 实例”那检查后台有没有 devenv.exe 或 vs_installer 进程残留全杀掉再重试。这种事虽然不是 QML 工程本身的报错但它挂在“VS 里跑 QML”这条链路上跑顺了就是一次性的跑不顺能把人卡一上午。我是建议先把这一步处理干净再折腾扩展和 Qt 包不然扩展装不上后面啥都白搭。5.4 调试器无法附加、断点不生效QML 断点不生效是比编译错误更让人挠头的问题。明明在 Main.qml 第 20 行打了断点F5 跑起来界面正常显示了但断点就是不命中变成一个空心圆。我排查下来原因基本逃不开以下几点第一构建配置是 Release。Release 模式下 qmlcachegen 会做激进优化QML 文件的源码位置信息和调试符号可能被剥离断点自然命中不了。切到 Debug 配置重新构建再看断点。第二QML 调试没有启用。Qt 6 里QML 调试验证需要条件编译宏来开启调试服务器。VS 的 Qt VS Tools 在 Debug 配置下会自动加但你如果手改过 CMakeLists 里的编译选项可能把它关了。检查 CMake 配置或者直接看启动参数里有没有-qmljsdebuggerport:...之类的字眼。第三运行的不是当前构建的 exe。这个属于操作问题有时你 F5 调试的路径指向的是别处拷贝的旧版本 exe代码和二进制完全对不上。确认项目属性里调试命令指向的是 build 输出目录里的新 exe。第四QML 文件被多次加载。如果你用engine.loadFromModule又从qrc:/加载了同名 QML引擎里存在多份组件实例断点可能命中的是另一份。这种排查起来麻烦但可以通过在构造函数或 onCompleted 里打个 qDebug 看加载的是哪份资源。5.5 QML 的导入环境变量设置关于QML_IMPORT_PATH的设置上面在原理部分已经讲了机制这里专门给一个具体的操作指南因为这块踩坑率极高。在 Windows 上如果你用 Visual Studio 开发设置这个环境变量的入口有系统级Windows 设置 系统 关于 高级系统设置 环境变量 新建。变量名QML_IMPORT_PATH值是自定义模块父目录多个路径用分号分隔。设完之后必须重启 Visual Studio。调试会话级VS 项目属性 调试 环境填入QML_IMPORT_PATHD:\path\to\your\modules。这个只对当前项目的调试会话生效不需要重启系统改完直接 F5 就带上。代码级在 main.cpp 里QQmlApplicationEngine engine;之后立即调用engine.addImportPath(D:/path/to/your/modules);。这个最灵活也是我推荐的生产环境做法因为它跟部署环境绑定不会因为开发机没配环境变量就挂。这三个层级从粗到细优先级也是代码级最高。如果你三个地方都设置了以代码级为准。实际项目里我一般开发阶段用调试会话级发布阶段在代码里硬编码相对路径相对 exe 目录的模块路径这样部署到别的机器上不会出现路径失效的问题。6. 这套流程在日常项目里的扩展与取舍写到这里Visual Studio 里创建 QML 工程的主流程基本走完了。最后聊点个人经验和这套方案的边界方便你决定是否真的要把日常开发迁到 VS 上。对于 C 和 QML 混合型项目VS 的体验确实比 Qt Creator 更顺手尤其是涉及到跨模块重构、符号查找、性能分析这些场景。QML 文件在 VS 里默认没有设计器预览纯 QML 界面调整时会觉得不如 Qt Creator 直观但 Vs 里装一个 Qt Quick 设计器扩展可以缓解或者开发时在 VS 里写逻辑、用 Qt Creator 双开看设计效果。我团队里现在就是这么分工的写代码和调试走 VS看视觉效果开 Creator 预览两边各取其长。新工程模板这块Qt VS Tools 生成的是比较基础的骨架。如果项目要上 QML 国际化lupdate/lrelease、qmldir 多模块管理、或者接入 Qt 的单元测试建议直接在 CMakeLists 里扩展不要指望模板全部生成好。VS 的 CMake 集成对增量修改的响应非常快改完 CMakeLists 保存一下VS 会自动重新 configure基本不需要手动点。最后提醒一下版本匹配Qt 6.8 对应 VS 2022 17.8Qt 6.9 要求 VS 2022 17.12。低版本 VS 配高版本 Qt 的 MSVC 包编译期会报“_MSC_VER 版本不匹配”或者干脆一堆头文件编译失败。如果你公司电脑的 VS 版本比较旧就老老实实装对应年份的 Qt 预编译包别为了追新把工具链搞得四不像。这套东西配置好一次之后后续创建新工程都是几分钟的事真正花时间的反而是那些环境级问题的排查——这也是我写这篇文章的原因希望你能绕开我踩过的这些坑。
![[通信与计算Adv-深度行业新闻]诺基亚与Blaize瞄准亚太地区的AI推理缺口](http://pic.xiahunao.cn/yaotu/[通信与计算Adv-深度行业新闻]诺基亚与Blaize瞄准亚太地区的AI推理缺口)
