拖拽QML ListView后同步更新C++ QStandardItemModel崩溃问题排查

核心问题分析 #

崩溃和同步异常的根源在于视图层（QML的visualModel）和数据层（C++模型）的操作顺序冲突，以及手动调用move时未严格遵循Qt模型的通知机制规范。

正确实现步骤 #

1. 取消QML侧的visualModel.items.move操作 #

不要在DropArea里直接修改visualModel的items顺序，DelegateModel会自动同步C模型的变化。拖拽时仅记录源索引和目标索引，最终由C模型处理移动，再通过Qt模型通知机制自动更新视图。

2. 规范C++模型的move操作 #

必须严格成对调用beginMoveRows和endMoveRows，这是Qt模型视图架构的核心，用于通知视图更新，避免视图与数据不同步：

void MyStandardItemModel::moveRow(int from, int to) {
    if (from == to) return;
    // 处理目标索引偏移：若目标在源之后，移动后目标索引需减1
    int adjustedTo = (to > from) ? to - 1 : to;

    beginMoveRows(QModelIndex(), from, from, QModelIndex(), adjustedTo);
    // 移动实际数据
    QStandardItem* item = takeItem(from);
    insertItem(adjustedTo, item);
    endMoveRows();
}

注：takeItem和insertItem是QStandardItemModel的内置方法，会自动处理数据结构，配合begin/endMoveRows可正确触发视图更新。

3. QML拖拽逻辑调整 #

拖拽过程中仅记录源和目标索引，释放鼠标时调用C++模型的moveRow方法：

ListView {
    id: listView
    model: DelegateModel {
        id: delegateModel
        model: cppModel // 你的C++模型实例
        delegate: CustomDelegate {}
    }

    MouseArea {
        anchors.fill: parent
        drag.target: parent
        drag.axis: Drag.YAxis
        property int dragStartIndex: -1

        onPressed: {
            dragStartIndex = listView.indexAt(mouseX, mouseY)
        }

        onReleased: {
            if (dragStartIndex === -1) return
            let dragEndIndex = listView.indexAt(mouseX, mouseY)
            if (dragEndIndex !== -1 && dragStartIndex !== dragEndIndex) {
                cppModel.moveRow(dragStartIndex, dragEndIndex)
            }
            dragStartIndex = -1
        }
    }
}

无需再操作visualModel.items，C++模型的move操作会通过DelegateModel自动同步到ListView。

4. 修复删除行异常问题 #

若之前删除单行时视图删两行，大概率是因为同时修改了visualModel和C模型，导致重复触发删除。统一由C模型处理删除：

void MyStandardItemModel::removeRow(int index) {
    beginRemoveRows(QModelIndex(), index, index);
    removeItem(index);
    endRemoveRows();
}

QML侧直接调用该方法即可，不要修改visualModel。

关键注意事项 #

• 永远不要同时修改视图层和数据层：Qt模型视图架构是数据层驱动视图层，所有数据变更都应在C++模型中完成，视图自动同步。
• 严格遵循模型通知机制：beginMoveRows/endMoveRows、beginRemoveRows/endRemoveRows必须成对调用，否则会导致视图内部状态混乱，引发崩溃或显示异常。
• DelegateModel仅做适配，不存储数据：DelegateModel负责将C++模型数据映射到QML委托，不要直接修改它的items集合。

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