PyQt中QTreeWidget与含字典列表的字典双向转换的问题及解决方案问询

你遇到的核心问题很明确：当字典里包含字典列表时，原代码会把列表内的所有字典项直接合并到同一个父节点下，转回字典时后面的项会覆盖前面的，完全丢失了列表结构。我来给你修改tree_from_dict和tree_2_dict两个函数，轻松解决这个问题。

问题根源 #

原代码处理列表时，直接把列表内的每个字典作为父节点的子节点，没有标记这些项属于列表；转回字典时，自然会把它们当成同一父键下的普通键值对，导致后项覆盖前项，列表结构完全丢失。

修改方案 #

我们的思路是：

1. 显示树形结构时，为列表的每个元素创建一个带索引标记的中间节点（比如Property[0]、Property[1]），让每个列表项独立显示。
2. 转回字典时，识别这些带索引标记的节点，把它们重新组装成列表，还原原始结构。

1. 修改tree_from_dict函数

修改列表处理逻辑，为每个列表元素生成带索引的父节点：

def tree_from_dict(self, data=None, parent=None):
    for key, value in data.items():
        item = QTreeWidgetItem(parent)
        item.setText(0, key)
        if isinstance(value, dict):
            self.tree_from_dict(data=value, parent=item)
        elif isinstance(value, list):
            # 为列表的每个元素创建带索引的中间节点
            for idx, child_val in enumerate(value):
                list_item = QTreeWidgetItem(item)
                # 用"键名[索引]"作为节点文本，标记这是列表项
                list_item.setText(0, f"{key}[{idx}]")
                if isinstance(child_val, dict):
                    self.tree_from_dict(child_val, parent=list_item)
                elif isinstance(child_val, list):
                    self.tree_from_dict(child_val, parent=list_item)
                else:
                    list_item.setText(1, str(child_val))
        else:
            item.setText(1, str(value))

2. 修改tree_2_dict函数

添加识别列表节点的逻辑，将带索引的节点重新组装成列表：

def tree_2_dict(self, parent, d=None):
    if d is None:
        d = {}
    # 先区分普通节点和列表节点
    list_collector = {}
    normal_nodes = {}

    for index in range(parent.childCount()):
        child = parent.child(index)
        child_key = child.text(0)
        # 判断是否是列表项格式：key[数字]
        if '[' in child_key and child_key.endswith(']'):
            base_key, idx_part = child_key.rsplit('[', 1)
            try:
                idx = int(idx_part[:-1])
            except ValueError:
                # 不是合法索引，当作普通节点处理
                normal_nodes[child_key] = child
                continue
            if base_key not in list_collector:
                list_collector[base_key] = []
            list_collector[base_key].append((idx, child))
        else:
            normal_nodes[child_key] = child

    # 处理普通键值对
    for key, child in normal_nodes.items():
        if child.childCount() > 0:
            self.tree_2_dict(child, d.setdefault(key, {}))
        else:
            d[key] = child.text(1)

    # 处理列表项：按索引排序后组装成列表
    for base_key, items in list_collector.items():
        # 按索引从小到大排序，保证列表顺序正确
        sorted_items = sorted(items, key=lambda x: x[0])
        result_list = []
        for idx, child in sorted_items:
            if child.childCount() > 0:
                sub_dict = {}
                self.tree_2_dict(child, sub_dict)
                result_list.append(sub_dict)
            else:
                result_list.append(child.text(1))
        d[base_key] = result_list

    return d

效果测试 #

用你提供的示例字典测试：

• 树形结构会清晰显示Property下的两个子节点Property[0]和Property[1]，每个节点下对应各自的字典内容。
• 点击保存按钮后，输出的字典会完美还原原始结构：

  {'TestName': {'Ref': 'ABC/DEF', 'Property': [{'Number': '2', 'Zipcode': '0002234', 'KeyAvailable': 'Yes'}, {'Number': '3', 'Zipcode': '2342444'}]}}
  

这个方案还兼容列表内的普通值（比如Property: [1, "abc", True]），同样能正确显示和还原。

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