如何在Qt Design Studio中模拟QQmlEngine上下文C++数据并支持界面编辑？

1. 基于环境变量的QML条件导入 #

在主QML入口文件中，通过检测QT_DESIGN_STUDIO环境变量，自动切换生产环境与设计环境的依赖对象：

// Main.qml
import QtQuick 2.15

// 条件导入模拟模块与生产模块
import "qrc:/design" as Design
import "qrc:/production" as Production

Item {
    // 根据环境选择模拟对象或真实C++对象
    property var myCppObject: Qt.os.environment.QT_DESIGN_STUDIO ? Design.MyCppMockObject : Production.MyCppObject
    property var listModel: Qt.os.environment.QT_DESIGN_STUDIO ? Design.MockListModel : Production.RealListModel
}

设计师在Qt Design Studio中打开时，会自动加载模拟资源，无需编译C++代码。

2. 纯QML实现模拟C++对象 #

在design目录下创建与真实C++对象接口一致的QML单例，返回静态模拟数据：

// design/MyCppMockObject.qml
pragma Singleton
import QtQuick 2.15

QtObject {
    // 复刻真实对象的属性结构
    property string userName: "测试用户"
    property int userLevel: 2

    // 模拟真实对象的方法逻辑
    function getUserDetail() {
        return {username: userName, level: userLevel, joinDate: "2024-01-01"}
    }
}

3. 用QML ListModel模拟C++列表模型 #

同样在design目录下创建模拟列表模型，与真实QAbstractListModel的数据结构对齐：

// design/MockListModel.qml
import QtQuick 2.15

ListModel {
    ListElement {
        title: "模拟列表项1"
        desc: "这是第一条模拟数据"
        isRead: false
    }
    ListElement {
        title: "模拟列表项2"
        desc: "这是第二条模拟数据"
        isRead: true
    }
    // 按需添加更多模拟条目
}

4. 主题样式的设计端实时切换 #

保留原有Style.qml单例，新增设计工具组件让设计师手动切换主题：

// design/ThemeSwitcher.qml
import QtQuick 2.15
import QtQuick.Controls 2.15

Item {
    // 仅在设计环境显示
    visible: Qt.os.environment.QT_DESIGN_STUDIO
    Row {
        anchors.top: parent.top
        anchors.right: parent.right
        anchors.margins: 16
        Button {
            text: "浅色模式"
            onClicked: Style.themeMode = ThemeMode.Light
        }
        Button {
            text: "深色模式"
            onClicked: Style.themeMode = ThemeMode.Dark
        }
    }
}

在主QML中引入该组件，设计师可直接在Qt Design Studio中切换主题，实时预览样式变化。

5. 项目结构与资源配置 #

• 将所有设计用的模拟文件、图标等资源放在独立的design目录，并加入QRC资源文件；生产环境编译时可通过qmake/CMake条件排除该目录（可选，减少包体积）。
• 单独创建design.qmlproject文件，仅包含设计所需的QML和资源，让设计师直接打开该项目即可编辑，无需依赖C++工程文件。

• 生产与设计代码完全隔离，设计师无需接触C++或编译流程。
• 模拟对象与真实C++对象接口一致，设计完成的QML可直接复用在生产环境。
• 支持主题与列表数据的实时预览，设计师能直观调整样式细节。

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