如何让Qt QListWidget移除自定义ItemWidget且不销毁它？

首先明确核心问题：Qt的setItemWidget()会让QListWidget接管传入Widget的所有权，后续当列表项被移除或调用clear()时，QListWidget会自动调用delete销毁对应的Widget。而你用std::unique_ptr<ItemWidget>持有Widget，这就造成了所有权冲突——两个对象都认为自己拥有Widget的生命周期控制权，必然会出现重复销毁或野指针问题。

要实现Widget独立于QListWidget存在的需求，可以按以下方式调整：

1. 手动移除列表项，避免自动销毁Widget #

不要直接调用clear()，而是遍历所有列表项，先将Widget从QListWidget的所有权中剥离，再删除列表项：

// 遍历所有列表项，逐个处理
while (auto item = ui->listWidget->takeItem(0)) {
    // 取出对应的Widget
    QWidget* widget = ui->listWidget->itemWidget(item);
    if (widget) {
        // 解除Widget与QListWidget的父子关系，转移所有权回自己的容器
        widget->setParent(nullptr);
    }
    // 删除列表项（此时不会销毁Widget）
    delete item;
}

2. 修正setItemWidget()的调用方式 #

你的循环代码中存在错误：遍历std::map<std::string, unique_ptr<ItemWidget>>时，it是std::pair对象，直接传it给setItemWidget()是错误的，应该传入裸指针it.second.get()。同时，为了不让QListWidget接管所有权，需要在设置前确保Widget的父控件为nullptr（如果之前有父的话）：

for (auto& entry : widgets) {
    auto* widget = entry.second.get();
    // 确保Widget当前无父控件，避免所有权被自动接管
    widget->setParent(nullptr);
    
    auto* item = new QListWidgetItem();
    item->setSizeHint(widget->size());
    ui->listWidget->addItem(item);
    // 传入裸指针，同时后续通过手动剥离父控件来保持所有权
    ui->listWidget->setItemWidget(item, widget);
}

3. 更优雅的方案：使用数据与视图分离的模型架构 #

如果频繁需要隐藏/显示Widget、控制生命周期，推荐改用QAbstractListModel配合QListView，或者直接使用自定义委托。这种方式下，你完全控制Widget的创建、销毁和显示逻辑，QListView仅负责渲染，不会接管Widget的所有权，从根源上避免所有权冲突。

关于你提到的setItemWidget()销毁Widget的问题 #

当调用setItemWidget()时，如果传入的Widget已经有父控件，Qt会自动将父控件改为QListWidget对应的内部容器，这意味着QListWidget会接管所有权。后续如果没有手动解除父子关系就移除列表项，Widget就会被销毁。所以关键是在设置和移除时，手动管理Widget的父控件，确保所有权始终在你的std::map容器中。

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