为何Qt 6与Qt 5的Qt Quick扩展插件表现存在差异？

核心原因 #

Qt 6对Qt Quick Controls 2的样式加载机制做了变更：Qt 5中Controls 2会自动加载适配平台的默认样式（如Material/Universal），但Qt 6中必须显式指定样式模块，否则控件没有视觉渲染逻辑，只会显示空白区域。

解决办法 #

方法1：在插件QML中直接导入样式模块 #

修改Qt 6版本的MyButton.qml，添加对应样式的导入语句即可：

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Basic // 可替换为Fusion、Material等样式

Button {
    width: 50
    height: 50
    text: "my button"
}

方法2：在应用全局指定样式 #

如果希望所有Controls都使用统一样式，可在应用入口main.cpp中设置全局样式：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQuickStyle>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    // 设置全局样式，可选值：Basic、Fusion、Material、Universal
    QQuickStyle::setStyle("Basic");

    QQmlApplicationEngine engine;
    engine.load(QUrl(u"qrc:/main.qml"_qs));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

补充说明 #

• Qt 6拆分样式模块的目的是优化应用体积，让开发者按需引入所需样式，避免不必要的资源加载。
• 不同样式的特性：
  • Basic：轻量级基础样式，适合对性能要求高的场景
  • Fusion：跨平台一致的样式，风格接近Qt Widgets的Fusion样式
  • Material：遵循Google Material Design规范
  • Universal：遵循Microsoft Fluent Design规范

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