Qt Creator运行Qt QML项目无界面显示问题求助

问题描述 #

在Qt Creator中使用Qt QML开发，运行main.qml后无任何界面显示，终端仅输出启动信息：

11:22:25: 启动 C:\Users\azus\Documents\build-sans_titre2-Desktop_Qt_6_4_3_MinGW_64_bit-Debug\appsans_titre2.exe...

涉及的main.qml代码：

import QtQuick 
import QtQuick.Window 
import QtQuick.VirtualKeyboard

Window {
    width: 100
    height: 100

    Rectangle {
        color: "red"
        anchors.fill: parent
    }
}

排查与解决步骤 #

1. 开启Window的可见性 #

Qt Quick的Window组件默认visible属性为false，这是无界面显示的最常见原因。只需在Window中添加visible: true即可：

Window {
    width: 100
    height: 100
    visible: true // 新增该行让窗口显示

    Rectangle {
        color: "red"
        anchors.fill: parent
    }
}

2. 验证main.cpp初始化逻辑 #

确保项目的main.cpp正确加载QML文件并完成应用初始化，示例代码如下：

#include <QGuiApplication>
#include <QQmlApplicationEngine>

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

    QQmlApplicationEngine engine;
    const QUrl url(u"qrc:/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();
}

• 确认url路径与main.qml的实际位置一致（若为本地文件而非资源文件，需改为QUrl::fromLocalFile("main.qml")）
• 检查是否正确引入QGuiApplication和QQmlApplicationEngine头文件

3. 清理不必要的模块依赖 #

若无需虚拟键盘功能，可移除import QtQuick.VirtualKeyboard语句，避免因模块未正确配置导致的潜在问题。若确实需要该模块，需在项目配置文件中添加依赖：

• CMakeLists.txt：

  find_package(Qt6 REQUIRED COMPONENTS Quick Window VirtualKeyboard)
  target_link_libraries(your_app_name PRIVATE Qt6::Quick Qt6::Window Qt6::VirtualKeyboard)
  

• .pro文件：

  QT += quick virtualkeyboard
  

4. 检查窗口显示状态 #

运行后查看任务栏是否有应用图标，尝试通过任务栏切换窗口，确认窗口是否被其他窗口遮挡或处于最小化状态。

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