Qt/QML中C++信号无法更新QML界面USB状态文本问题

1. 修复QML的信号连接与属性绑定 #

原QML代码存在对象名不匹配、冗余调用的问题，直接绑定Q_PROPERTY属性是最简洁可靠的方式：

Text {
    id: label
    // 直接绑定C++端的usbCheck属性，状态变化时自动更新
    text: UsbStateDetect.usbCheck
}

// 如需监听状态变化做额外操作，正确的Connections写法
Connections {
    target: UsbStateDetect
    function onUsbCheckChanged(newState) {
        console.log("USB状态变更:", newState)
        // 这里可添加额外业务逻辑，无需调用get方法
    }
}

2. 启用线程中的信号发射并优化循环逻辑 #

原代码中emit usbCheckChanged(m_usbCheck)被注释，且线程循环无退出机制，修改UsbStateDetect.cpp的run()函数：

void UsbStateDetect::run()
{
    timeval tv;
    tv.tv_sec = 0;
    tv.tv_usec = 5000000;
    // 用Stop变量控制循环，避免程序退出时无法终止线程
    while(!Stop){
        if (libusb_handle_events_timeout_completed(NULL, &tv, NULL) == 0){
            QString newState;
            if (status_flag == 1){
                newState = "USB Device Connected";
            }
            else if (status_flag == 0){
                newState = "USB Device Removed";
            }
            // 仅状态变化时更新并发射信号，减少不必要的触发
            if(newState != m_usbCheck){
                m_usbCheck = newState;
                qDebug()<<"Result: "<< m_usbCheck;
                emit usbCheckChanged(m_usbCheck); // 启用信号发射
            }
            this->msleep(100);
        }
    }
}

3. 移除main.cpp中的无效连接 #

原代码中把usbCheckChanged信号连接到getUsbStateDetect方法完全多余，直接删除该行：

// 删除这行无效代码
// QObject::connect(&usbStateDetect,&UsbStateDetect::usbCheckChanged, &usbStateDetect,&UsbStateDetect::getUsbStateDetect);

4. 完善Q_PROPERTY读取函数（规范实现） #

确保usbCheck()函数正确返回成员变量：

QString UsbStateDetect::usbCheck() const
{
    return m_usbCheck;
}

5. 启动检测线程 #

在main.cpp中添加线程启动代码，否则检测逻辑不会执行：

int main(int argc, char *argv[])
{
    // ... 其他初始化代码 ...
    engine.load(url);
    // 启动USB状态检测线程
    usbStateDetect.start();
    return app.exec();
}

关键注意事项 #

• 若status_flag是跨线程访问的全局变量，需用QMutex保护，避免竞态条件
• QML直接绑定Q_PROPERTY是Qt推荐的双向数据同步方式，无需手动调用get方法
• 线程循环必须提供退出机制（如Stop变量），避免程序退出时线程无法正常终止

内容的提问来源于stack exchange，提问作者Şahin Şengül