QT/C++：ListWidgetItem复选框触发槽函数失败的信号与槽问题

我来帮你梳理下问题所在，然后给出可行的解决方案：

首先看你代码里的几个明显错误：

• 信号写法完全不对：你用SIGNAL(item->checkState())是不符合Qt信号槽规则的，QListWidget根本没有这个信号。旧的SIGNAL/SLOT宏要求填写信号的函数签名，而不是直接访问item的属性。
• 重复连接信号：你在循环遍历每个item时都执行一次connect，这会导致同一个信号被多次绑定到槽函数，后续触发一次状态变化会多次执行slotTest，完全没必要。
• 没用到正确的信号：QListWidget提供了itemChanged(QListWidgetItem*)信号，当item的复选框状态、文本内容等发生变化时都会触发，这才是你需要监听的信号。

修正后的代码实现 #

第一步：正确初始化ListWidget并设置item属性 #

先把item的初始化做好，注意不要在循环里做信号连接：

QStringList list;
list << "CH1 100kHz" << "CH2 100kHz" << "CH3 100kHz";
ui->listWidget->addItems(list);

QListWidgetItem* item = nullptr;
for(int i = 0; i < ui->listWidget->count(); ++i){
    item = ui->listWidget->item(i);
    // 开启复选框可编辑和用户勾选权限
    item->setFlags(item->flags() | Qt::ItemIsUserCheckable);
    item->setFlags(item->flags() | Qt::ItemIsEditable);
    // 默认设置为未勾选
    item->setCheckState(Qt::Unchecked);
}

第二步：正确连接信号槽 #

把连接代码移到循环外面，只需要连接一次：

方式一：兼容Qt4/5的旧语法

connect(ui->listWidget, SIGNAL(itemChanged(QListWidgetItem*)), 
        this, SLOT(slotTest(QListWidgetItem*)), 
        Qt::QueuedConnection);

方式二：Qt5+推荐的新语法（类型更安全）

如果你用的是Qt5及以上版本，强烈建议用这种写法，编译期就能检查出信号和槽是否匹配，避免拼写错误：

connect(ui->listWidget, &QListWidget::itemChanged,
        this, &YourClass::slotTest,
        Qt::QueuedConnection);

第三步：实现槽函数 #

首先在你的类头文件里声明槽函数：

// 替换成你的类名，比如MainWindow
class YourClass : public QWidget
{
    Q_OBJECT
    // ... 其他成员声明
private slots:
    void slotTest(QListWidgetItem* item);
};

然后在cpp文件里实现槽函数，这里可以拿到变化的item，处理复选框状态：

void YourClass::slotTest(QListWidgetItem* item){
    // 获取当前复选框状态
    Qt::CheckState currentState = item->checkState();
    // 可以输出调试信息，或者写你的业务逻辑
    qDebug() << "条目" << item->text() << "的状态变为:" 
             << (currentState == Qt::Checked ? "已勾选" : "未勾选");
    
    // 这里写你原来slotTest里的业务代码
}

额外小提示 #

• 你代码里同时初始化了listView和listWidget，如果不需要listView的话可以删掉，避免自己混淆。
• 如果只想监听复选框状态变化（而不是item文本编辑的变化），可以在槽函数里加个判断，比如记录每个item的上一次状态，对比后再处理，不过一般直接用当前状态也能满足需求。

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