为QTreeView添加QSortFilterProxyModel后程序崩溃问题排查

1. 模型索引混淆（最常见崩溃诱因） #

• 你通过QTreeView::currentIndex()拿到的是代理模型的索引，如果添加/编辑按钮的逻辑直接用这个索引操作原始模型（比如QStandardItemModel），会因为索引不属于原始模型导致崩溃或异常。
  • 解决：必须调用QSortFilterProxyModel::mapToSource()把代理索引转换为原始模型的索引后再操作。
  • 错误示例：

    // 直接用代理索引操作原始模型，必然崩溃
    auto idx = treeView->currentIndex();
    model->setData(idx, newText);
    

  • 正确示例：

    auto proxyIdx = treeView->currentIndex();
    auto sourceIdx = proxyModel->mapToSource(proxyIdx);
    if (sourceIdx.isValid()) {
        model->setData(sourceIdx, newText);
    }
    

2. 代理模型生命周期异常 #

• 如果代理模型是局部变量（比如在函数内创建后直接赋值给treeView，函数结束后被销毁），会导致treeView访问野指针触发崩溃。
  • 解决：将QSortFilterProxyModel声明为类成员变量，确保其生命周期与treeView、原始模型一致。

3. 源模型设置错误 #

• 忘记调用proxyModel->setSourceModel(model)，或者多次设置源模型导致模型层级混乱，引发崩溃或数据异常。
  • 解决：确保只调用一次setSourceModel，且在把代理模型设置给treeView之前完成：

    proxyModel->setSourceModel(model);
    treeView->setModel(proxyModel);
    

4. 过滤逻辑错误导致索引失效 #

• 如果自定义了filterAcceptsRow等过滤函数，逻辑错误可能导致部分索引被错误过滤，当按钮操作这些“不存在”的索引时引发异常。
  • 解决：检查过滤函数的逻辑，确保过滤规则正确，且过滤后仍能正确映射到源模型的有效索引。

5. 信号槽连接未适配代理模型 #

• 添加/编辑按钮的槽函数如果直接绑定到原始模型的信号，未考虑代理模型的中间层，可能导致信号传递异常，按钮无法稳定工作。
  • 解决：需要监听模型数据变化时，应该监听代理模型的信号，或确保槽函数中使用转换后的源索引。

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