QT6/C++：多QListWidget切换选择时textEdit显示异常问题

问题场景与异常现象 #

实现功能：多个QListWidget项关联到textEdit，点击项时显示对应描述；支持通过按钮将项移动到其他列表，描述同步跟随，使用QMap存储项与描述的映射。

异常：当项移动到第二个列表（或点击第二个列表项）后，再点击第一个列表的项，第一个列表项会显示第二个列表项的描述（例如点击“2”却显示“three”）。仅切换不同列表选择时触发，同一列表内切换正常。

问题代码 #

用户绑定的点击信号处理与文本变更处理代码如下：

void MainWindow::on_ToDoList_itemClicked(QListWidgetItem *item)
{
    ui -> InProgressList -> clearSelection();
    ui -> DoneList -> clearSelection();
    QString buff = item -> text();
    ui -> textEdit -> setText(record.value(buff));
}

// 问题核心函数
void MainWindow::on_textEdit_textChanged()
{
    QListWidgetItem* check;
    if(ui -> ToDoList -> currentItem() != NULL) check = ui -> ToDoList -> currentItem();
    if(ui -> InProgressList -> currentItem() != NULL) check = ui -> ToDoList -> currentItem();
    if(ui -> DoneList -> currentItem() != NULL) check = ui -> ToDoList -> currentItem();
    QString title = check -> text();
    QString buff = ui -> textEdit -> toPlainText();
    record[title] = buff;
}

问题根源 #

on_textEdit_textChanged()中的if判断逻辑完全错误：所有分支都将check赋值为ToDoList的当前项，无论实际选中的是哪个列表的项。这导致修改textEdit内容时，总是把新描述覆盖到ToDoList当前项（甚至是之前选中的旧项）对应的QMap键上，后续点击其他列表项时，读取的是被错误覆盖的映射值，从而出现描述串位的问题。

修复方案 #

1. 修正文本变更时的选中项判断逻辑 #

void MainWindow::on_textEdit_textChanged()
{
    QListWidgetItem* check = nullptr;
    // 按顺序检查哪个列表存在选中项
    if (ui->ToDoList->currentItem() != nullptr) {
        check = ui->ToDoList->currentItem();
    } else if (ui->InProgressList->currentItem() != nullptr) {
        check = ui->InProgressList->currentItem();
    } else if (ui->DoneList->currentItem() != nullptr) {
        check = ui->DoneList->currentItem();
    }

    // 确保存在有效选中项时再更新映射
    if (check != nullptr) {
        QString title = check->text();
        QString buff = ui->textEdit->toPlainText();
        record[title] = buff;
    }
}

2. 优化列表点击时的选中状态清理 #

除了clearSelection()，额外设置其他列表的currentItem为nullptr，避免残留选中状态干扰判断：

void MainWindow::on_ToDoList_itemClicked(QListWidgetItem *item)
{
    ui->InProgressList->clearSelection();
    ui->InProgressList->setCurrentItem(nullptr);
    ui->DoneList->clearSelection();
    ui->DoneList->setCurrentItem(nullptr);
    
    QString buff = item->text();
    ui->textEdit->setText(record.value(buff));
}
// 同理，InProgressList和DoneList的itemClicked信号处理函数也需要添加对应的清空逻辑

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