Qt6编译QtMqtt等特定模块时安装失败该如何解决？

首先纠正一个常见误区：Qt6完全支持单独编译单个模块，不需要下载完整Qt源码全量编译，之前的操作流程走了弯路，安装报错也来自全量编译的配置错误。

准备工作 #

• 先通过Qt安装器装好对应版本（以你用的6.2.0为例）的预编译Qt套件，同时勾选安装配套的CMake、Ninja、对应编译器（MinGW或MSVC），这些都可以在Qt安装器的「开发者工具」分类下找到。
• 下载和你本地Qt版本完全一致的QtMqtt源码，比如你用Qt 6.2.0就拉取v6.2.0标签的源码，不要拉取最新开发分支避免版本不兼容。

编译步骤 #

1. 打开对应Qt套件的专属命令行终端：比如你用的是6.2.0 MSVC2019 64位套件，直接从开始菜单的Qt文件夹下找到Qt 6.2.0 (MSVC 2019 64-bit)的命令行入口打开，不需要手动配置环境变量。
2. 进入你解压好的QtMqtt源码根目录，依次执行以下命令：
   • 创建并进入构建目录：
     mkdir build && cd build
   • 执行模块配置（直接调用Qt自带的模块配置工具，不需要全量源码）：
     qt-configure-module ..
   • 执行编译：
     cmake --build . --parallel
   • 执行安装，命令会自动将生成的dll、头文件、CMake配置文件拷贝到你本地Qt的对应安装目录：
     cmake --install .

原操作报错原因 #

你之前走的是全量编译整个Qt源码的流程，安装报错是因为configure阶段的prefix路径设置错误，且全量编译过程中部分依赖模块没有完整生成，导致安装时找不到依赖的pri文件。全量编译只适合需要修改Qt基础模块的场景，编译单个额外模块用上述单独编译的方案效率更高，也不会出现依赖缺失的问题。

验证方法 #

安装完成后，你可以在Qt安装目录的6.2.0/[你的套件名]/bin路径下找到Qt6Mqtt.dll，头文件会出现在同级的include/QtMqtt目录下，在自己的项目CMake配置中加入find_package(Qt6 REQUIRED COMPONENTS Mqtt)即可正常调用该模块。

内容的提问来源于stack exchange，提问作者Jens