删除QT QListWidget条目后出现未删除/其他条目损坏问题

问题原因分析 #

你遇到的问题源于两个核心错误：

1. 跨线程操作QT UI控件
   QT所有UI控件仅允许在**主线程（GUI线程）**中操作，你用std::thread创建的异步线程直接调用display()操作QListWidget，属于线程违规操作，会导致UI渲染异常、控件状态损坏。
2. 条目删除的循环逻辑错误
   即使在主线程执行当前循环，逻辑也存在问题：
   • 初始列表为[1,2,3,4,5]，i=0时删除条目1，列表变为[2,3,4,5]
   • i=1时，取列表索引1的条目（原条目3）删除，列表变为[2,4,5]
   • i=2时取索引2的条目（原条目5）删除，列表变为[2,4]
   • 循环到i=3和i=4时，列表已无对应索引的条目，最终残留2和4。

正确实现方法 #

方法1：修复逻辑+主线程执行 #

步骤1：修正跨线程问题

改用QT信号槽机制将删除操作切换到主线程：
先在mainwindow.h添加信号：

class MainWindow : public QMainWindow
{
    Q_OBJECT
signals:
    void startDeleteItems();
    // ... 其他原有代码
};

修改mainwindow.cpp，在构造函数中连接信号槽，并重写删除逻辑：

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    connect(this, &MainWindow::startDeleteItems, this, &MainWindow::deleteItems);
}

// 新增在主线程执行的删除槽函数
void MainWindow::deleteItems()
{
    // 方式A：倒序删除，避免索引偏移
    for(int i = ui->listWidget->count() - 1; i >= 0; i--)
    {
        auto item = ui->listWidget->takeItem(i);
        delete item;
    }
    // 方式B：逐个删除第0个条目，直到列表为空
    // while(ui->listWidget->count() > 0)
    // {
    //     auto item = ui->listWidget->takeItem(0);
    //     delete item;
    // }
}

void MainWindow::display()
{
    sleep(15);
    // 发送信号触发主线程执行删除
    emit startDeleteItems();
}

步骤2：简化延迟触发（推荐）

用QT的QTimer替代线程实现延迟，更符合QT开发规范：

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();

    // 延迟15秒触发删除操作
    QTimer::singleShot(15000, &w, &MainWindow::deleteItems);

    a.exec();
    return 0;
}

方法2：直接清空所有条目（最简洁） #

如果不需要逐个删除的额外逻辑，直接调用QListWidget的内置方法一键清空：

void MainWindow::deleteItems()
{
    ui->listWidget->clear();
}

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