VS2022中使用QT Visual Studio Tools调用MessageDialog报错求助

错误信息 #

QQmlApplicationEngine failed to load component
qrc:/display/x86/qml/display/x86/Main.qml:6:2: plugin cannot be loaded for module "QtQuick.Dialogs": Cannot protect module QtQuick.Dialogs 2 as it was never registered

解决方法 #

1. 确认项目已正确添加Dialogs模块依赖 #

在VS项目中检查Qt模块配置：

• 右键项目 → 属性 → Qt项目设置 → 模块，确保勾选qtquickdialogs2（对应Qt5.15版本的Dialogs模块）
• 若使用qmake的.pro文件，需添加QT += quickdialogs2

2. 显式注册模块（C++代码中） #

部分场景下需要在main.cpp中手动注册QtQuick.Dialogs模块，确保引擎能识别：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QtQuickDialogs2>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    // 注册指定版本的Dialogs模块
    qmlRegisterModule("QtQuick.Dialogs", 2, 15);

    const QUrl url(u"qrc:/display/x86/qml/display/x86/Main.qml"_qs);
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                     &app, [url](QObject *obj, const QUrl &objUrl) {
        if (!obj && url == objUrl)
            QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

3. 修正QML中MessageDialog的使用方式 #

MessageDialog不能作为根组件，必须绑定到Window或其他可视组件作为父项：

import QtQuick 2.15
import QtQuick.Window 2.15
import QtQuick.Controls 2.15
import QtQuick.Layouts 1.15
import QtQuick.Dialogs 2.15

Window {
    id: mainWindow
    visible: true
    width: 640
    height: 480
    title: qsTr("Demo")

    MessageDialog {
        id: dialog
        parent: mainWindow
        text: "The document has been modified."
        informativeText: "Do you want to save your changes?"
        buttons: MessageDialog.Ok | MessageDialog.Cancel
        onAccepted: console.log("Save changes")
        onCancel: dialog.close()
    }

    Button {
        anchors.centerIn: parent
        text: "Show Dialog"
        onClicked: dialog.open()
    }
}

4. 清理重建项目 #

• 执行项目清理操作（右键项目 → 清理）
• 删除build目录下的所有生成文件
• 重新生成解决方案，确保依赖库正确链接

5. 验证Qt版本兼容性 #

确保使用的Qt版本为5.15.x，QML中导入的模块版本2.15必须与Qt版本匹配，避免版本不兼容导致的模块注册失败。

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