PyQt5：实现QAbstractTableModel与数据字典双向同步

核心问题分析 #

你遇到的问题根源在于错误使用了layoutChanged信号——该信号仅用于通知视图行列结构（比如行数/列数）变化，而数据内容更新需要用dataChanged信号。同时，双向同步的核心是让模型统一管理数据，避免直接修改外部字典导致视图与数据脱节。

一、双向同步的正确实现（自定义模型） #

继承QAbstractTableModel实现自定义模型，让模型持有峰数据字典，所有数据修改都通过模型接口完成，自动触发视图刷新：

from PyQt5.QtCore import QAbstractTableModel, Qt, QModelIndex

class PeakTableModel(QAbstractTableModel):
    def __init__(self, initial_data=None, parent=None):
        super().__init__(parent)
        # 内部存储峰数据：{peak_id: {'x': 数值, 'y': 数值, 'label': 标签}}
        self._peak_data = initial_data if initial_data else {}
        # 定义表格列对应的字段
        self._columns = ["x", "y", "label"]

    # 重写行数计算
    def rowCount(self, parent=QModelIndex()):
        return len(self._peak_data)

    # 重写列数计算
    def columnCount(self, parent=QModelIndex()):
        return len(self._columns)

    # 重写数据读取逻辑
    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid() or role not in (Qt.DisplayRole, Qt.EditRole):
            return None
        
        peak_ids = list(self._peak_data.keys())
        current_peak_id = peak_ids[index.row()]
        current_field = self._columns[index.column()]
        return self._peak_data[current_peak_id].get(current_field, "")

    # 重写数据修改逻辑（表格编辑自动更新字典）
    def setData(self, index, value, role=Qt.EditRole):
        if role != Qt.EditRole or not index.isValid():
            return False
        
        peak_ids = list(self._peak_data.keys())
        current_peak_id = peak_ids[index.row()]
        current_field = self._columns[index.column()]
        
        # 更新内部字典
        self._peak_data[current_peak_id][current_field] = value
        # 发出数据变化信号，指定刷新范围
        self.dataChanged.emit(index, index)
        return True

    # 重写表头显示
    def headerData(self, section, orientation, role=Qt.DisplayRole):
        if role != Qt.DisplayRole:
            return None
        if orientation == Qt.Horizontal:
            return self._columns[section]
        # 行表头显示峰ID
        peak_ids = list(self._peak_data.keys())
        return peak_ids[section] if section < len(peak_ids) else ""

    # 外部添加峰数据（自动刷新表格）
    def add_peak(self, peak_id, peak_info):
        self.beginInsertRows(QModelIndex(), self.rowCount(), self.rowCount())
        self._peak_data[peak_id] = peak_info
        self.endInsertRows()

    # 外部更新峰数据（自动刷新表格）
    def update_peak(self, peak_id, updated_info):
        if peak_id not in self._peak_data:
            return
        # 找到对应行索引
        row_idx = list(self._peak_data.keys()).index(peak_id)
        # 更新数据
        self._peak_data[peak_id].update(updated_info)
        # 刷新整行
        top_left = self.index(row_idx, 0)
        bottom_right = self.index(row_idx, self.columnCount() - 1)
        self.dataChanged.emit(top_left, bottom_right)

    # 允许表格编辑
    def flags(self, index):
        return super().flags(index) | Qt.ItemIsEditable

二、双向同步的使用方式 #

1. 表格编辑自动更新字典
   确保TableView开启编辑触发器：

   from PyQt5.QtWidgets import QTableView
   
   table_view = QTableView()
   model = PeakTableModel()
   table_view.setModel(model)
   # 设置允许双击或按编辑键触发编辑
   table_view.setEditTriggers(QTableView.DoubleClicked | QTableView.EditKeyPressed)
   

   用户编辑表格单元格时，setData方法会自动更新模型内部的_peak_data字典，无需额外处理。

2. 字典变化自动更新表格
   不要直接修改外部字典，通过模型提供的add_peak/update_peak方法操作数据：

   # 点击Matplotlib图表添加峰时调用
   new_peak_id = f"peak_{len(model._peak_data) + 1}"
   model.add_peak(new_peak_id, {"x": 123.4, "y": 567.8, "label": "峰1"})
   
   # 外部修改峰数据时调用
   model.update_peak("peak_1", {"x": 125.0})
   

   这些方法会自动触发正确的信号，让TableView实时刷新。

三、数据导出功能 #

1. 导出为字典
   直接调用模型的方法获取数据副本（避免外部修改影响模型内部数据）：

   def export_to_dict(model):
       return model._peak_data.copy()
   

2. 导出为DataFrame
   利用Pandas直接将模型内部字典转为DataFrame：

   import pandas as pd
   
   def export_to_dataframe(model):
       return pd.DataFrame.from_dict(model._peak_data, orient="index", columns=model._columns)
   

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