Qt6.4.1中QtQuick.Studio.Components调试与发布版本兼容问题求助

需求目标 #

在Windows10系统的Qt QML社区版应用中，同时在Debug和Release构建版本中使用QtQuick.Studio.Components。

操作过程 #

项目使用qmake而非cmake，需手动编译该模块，参考官方文档步骤执行编译，调整后的cmake命令为：

cmake -GNinja --DCMAKE_INSTALL_PREFIX=C:\Qt\6.4.1\msvc2019_64\  C:\temp\designer2\qtquickdesigner-components

问题现象 #

Debug构建无报错，Release构建时出现错误：

'C:/Qt/6.4.1/msvc2019_64/qml/QtQuick/Studio/Components/quickstudiocomponentsplugind.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)

疑问 #

1. 如何同时构建该插件的Debug和Release版本？
2. 如何指定安装前缀，因Qt安装目录中未区分Debug和Release版本？

解决方案 #

针对疑问1：同时构建Debug和Release版本 #

• 为两种版本创建独立的构建目录，分开执行编译流程：
  • Debug版本编译命令：

    cmake -GNinja -DCMAKE_BUILD_TYPE=Debug --DCMAKE_INSTALL_PREFIX=C:\Qt\6.4.1\msvc2019_64\debug C:\temp\designer2\qtquickdesigner-components
    ninja install
    

  • Release版本编译命令：

    cmake -GNinja -DCMAKE_BUILD_TYPE=Release --DCMAKE_INSTALL_PREFIX=C:\Qt\6.4.1\msvc2019_64\release C:\temp\designer2\qtquickdesigner-components
    ninja install
    

• 独立目录编译可以彻底避免Debug与Release库文件混装导致的兼容性冲突。

针对疑问2：处理Qt安装目录无Debug/Release区分的问题 #

Qt的MSVC版本默认未拆分Debug和Release目录，可通过以下两种方式处理：

1. 子目录安装+项目配置指定路径
   按上述命令将Debug版本安装到C:\Qt\6.4.1\msvc2019_64\debug，Release版本安装到C:\Qt\6.4.1\msvc2019_64\release，然后在项目的.pro文件中根据构建类型导入对应路径：

   win32:CONFIG(release, debug|release) {
       QML_IMPORT_PATH += C:\Qt\6.4.1\msvc2019_64\release\qml
   }
   win32:CONFIG(debug, debug|release) {
       QML_IMPORT_PATH += C:\Qt\6.4.1\msvc2019_64\debug\qml
   }
   

2. 手动区分插件文件名
   编译完成后，保留Debug版本插件的d后缀（如quickstudiocomponentsplugind.dll），将Release版本插件重命名为不带d的形式（如quickstudiocomponentsplugin.dll）。Qt会自动根据当前构建模式加载对应后缀的插件，但这种方式需注意后续更新插件时避免文件覆盖，优先推荐子目录方案。

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