PySide6 Qt6：TreeView编辑后无法完整更新JSON模型的问题

核心问题定位 #

你的问题大概率出在setData()方法未正确定位层级节点对应的底层JSON数据，或是修改后未正确触发模型的dataChanged信号，导致修改无法同步到底层数据，最终保存时丢失。

具体修复步骤 #

1. 确保setData()正确定位层级节点的JSON数据 #

Qt TreeModel的索引（index）通过internalPointer()关联到自定义的TreeItem（或直接关联JSON对象），你需要确保修改的是当前索引对应的具体层级JSON元素，而非仅顶层节点：

from PySide6.QtCore import Qt, QAbstractItemModel, QModelIndex

class JsonTreeModel(QAbstractItemModel):
    def __init__(self, root_data, parent=None):
        super().__init__(parent)
        self.root_item = TreeItem(root_data)  # 自定义TreeItem持有JSON数据引用

    def setData(self, index, value, role=Qt.ItemDataRole.EditRole):
        if not index.isValid() or role != Qt.ItemDataRole.EditRole:
            return False

        # 获取当前索引对应的TreeItem（持有JSON数据引用）
        current_item = index.internalPointer()
        # 根据你的JSON结构修改对应字段，比如节点名称存在"label"键
        if isinstance(current_item.data, dict):
            current_item.data["label"] = value
        # 如果是数组型层级节点，修改父节点数组中对应位置的元素
        elif isinstance(current_item.parent().data, list):
            current_item.parent().data[index.row()] = value

        # 必须触发dataChanged信号，通知视图更新
        self.dataChanged.emit(index, index, [Qt.ItemDataRole.DisplayRole, Qt.ItemDataRole.EditRole])
        return True

2. 确保flags()对所有层级节点开放编辑权限 #

不要只给顶层节点开编辑权限，所有需要编辑的节点都要返回正确的flags：

def flags(self, index):
    if not index.isValid():
        return Qt.ItemFlag.NoItemFlags
    # 对所有有效节点开放编辑、选中、启用权限
    return Qt.ItemIsEditable | Qt.ItemIsEnabled | Qt.ItemIsSelectable

3. 保存JSON时递归序列化整个层级结构 #

保存时要从根节点开始递归遍历所有子节点，确保层级数据被完整序列化：

import json

def save_to_json(self, file_path):
    def serialize_item(item):
        data = item.data.copy()
        # 递归序列化子节点（假设子节点对应JSON的"children"键）
        if item.hasChildren():
            data["children"] = [serialize_item(item.child(i)) for i in range(item.rowCount())]
        return data

    # 从根节点的子节点开始序列化（根节点通常是容器）
    root_serialized = [serialize_item(self.root_item.child(i)) for i in range(self.root_item.rowCount())]
    with open(file_path, "w", encoding="utf-8") as f:
        json.dump(root_serialized, f, indent=4, ensure_ascii=False)

关键注意事项 #

• 确保TreeItem的data属性是引用类型（dict/list），而非值类型（str/int），这样修改TreeItem的data时才会直接修改底层JSON数据，而非副本。
• 加载JSON构建TreeItem时，要确保子节点的data直接引用父节点JSON对象中的children数组元素，而非深拷贝的副本。

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