QML加载报错‘ComboBoxStyle不是类型’的修复方法咨询

错误原因 #

ComboBoxStyle是Qt Quick Controls 1的专属API，而你使用的是Qt Quick Controls 2.15——Controls 2采用了全新的组件化样式系统，彻底移除了style属性，改用background、contentItem等内置属性定制控件外观。同时，用QQuickView加载ApplicationWindow会导致窗口嵌套，引发空窗口问题。

分步修复 #

1. 修改QML代码，替换ComboBoxStyle #

移除原有的style代码块，改用Controls 2的原生属性实现相同样式效果：

import QtQuick 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    visible: true
    width: 300
    height: 200
    title: "Simple ComboBox Example"

    ComboBox {
        id: comboBox
        width: 200
        model: ["Option 1", "Option 2", "Option 3"]
        currentIndex: 0

        // 自定义背景边框
        background: Rectangle {
            implicitWidth: 100
            implicitHeight: 25
            border.width: 1
            color: comboBox.pressed ? "#eee" : "white"
        }

        // 自定义下拉选项样式
        delegate: ItemDelegate {
            width: comboBox.width
            text: modelData
            font.pixelSize: 12
            padding.left: 5
            highlighted: comboBox.highlightedIndex === index
        }

        // 自定义下拉弹出框
        popup: Popup {
            y: comboBox.height
            width: comboBox.width
            implicitHeight: contentItem.implicitHeight
            contentItem: ListView {
                model: comboBox.popup.visible ? comboBox.model : null
                currentIndex: comboBox.highlightedIndex
                delegate: comboBox.delegate
            }
        }

        // 自定义选中项的显示文本
        contentItem: Label {
            anchors.fill: parent
            padding.left: 5
            font.pixelSize: 12
            text: comboBox.currentText
            verticalAlignment: Qt.AlignVCenter
        }
    }
}

2. 调整main.cpp，使用正确的窗口加载方式 #

ApplicationWindow必须用QQmlApplicationEngine加载（QQuickView仅适用于加载Window或普通Item），否则会出现窗口嵌套、内容不显示的问题：

#include <QGuiApplication>
#include <QQmlApplicationEngine>

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

    QQmlApplicationEngine engine;
    const QUrl url(u"qrc:/app.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. 优化CMakeLists.txt（可选） #

移除不必要的Widgets组件依赖（Quick应用无需Widget支持），保持配置简洁：

cmake_minimum_required(VERSION 3.27)
project(QtQmlTest)

set(CMAKE_CXX_STANDARD 23)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

add_executable(${PROJECT_NAME} main.cpp)

find_package(Qt6 REQUIRED COMPONENTS Core Gui Quick QuickControls2)
target_link_libraries(${PROJECT_NAME} Qt::Core Qt::Gui Qt::Quick Qt::QuickControls2)

qt_add_resources(${PROJECT_NAME} "qml"
        PREFIX "/"
        BASE ${PROJECT_SOURCE_DIR}
        FILES app.qml)

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