如何在Qt GammaRay中查看QML单例的运行时值？

针对你遇到的QML单例（Config.qml）在GammaRay中无法定位、查看运行时值的问题，结合你的环境（Windows 10、GammaRay v3.3、Qt 6.9、llvm_mingw），可以尝试以下几种方法：

1. 从QML上下文浏览器查找 #

QML单例通常会被注册到QML根上下文或对应模块的上下文环境中，GammaRay的QML Context Explorer是最直接的入口：

• 在GammaRay左侧导航栏找到「QML Contexts」选项，展开根上下文（Root Context）或你的QML模块对应的上下文
• 在上下文的属性列表中查找Config（或模块限定名，比如YourModule.Config），点击即可查看其所有属性的实时值

2. 切换Object Explorer视图并精准搜索 #

常规的「Scene Objects」视图只显示可视化组件树，QML单例不属于这个树结构，需要切换到全局对象视图：

• 在GammaRay的「Object Explorer」中，切换顶部视图选项为All Objects
• 使用搜索框搜索单例的完整类型名（比如你的模块名+Config，格式为ModuleName::Config），而非仅搜「Config」
• 如果找到对应实例，点击即可查看其属性的运行时值

3. 手动在C++层暴露单例实例给GammaRay #

如果上述方法无法找到实例，可以通过C++代码主动将QML单例注册到GammaRay中：

#include <QQmlEngine>
#include <gammaray/core/probe.h>

// 确保在Config实例已被创建后调用（比如程序启动完成、JSON解析完成后）
void registerConfigToGammaRay() {
    // 替换为你的QML模块名、版本号和单例类型名
    QObject* configInstance = QQmlEngine::instance()->singletonInstance("YourModule", "1.0", "Config");
    if (configInstance) {
        // 将实例注册到GammaRay，分类名为「Global Config」
        GammaRay::Probe::instance()->registerObject("Global Config", configInstance);
    }
}

编译运行后，GammaRay会在单独的分类下显示Config实例，直接查看属性值即可。

4. 确认单例实例已被实例化 #

QML单例采用懒加载机制，只有当被其他QML组件引用时才会创建实例。如果你的程序逻辑中存在延迟引用的情况，可能实例尚未创建，此时GammaRay自然无法捕获。可以在QML代码中提前触发实例化（比如在根组件中添加import YourModule 1.0; Config {}），再重新附加GammaRay查看。

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