PySide6 QAbstractTableModel触发dataChanged时内存泄漏问题排查

1. 全量dataChanged触发导致的视图缓存堆积 #

你当前用dataChanged()通知全表更新，QTableView会重新渲染所有单元格，旧的单元格渲染对象、数据缓存可能无法被GC及时回收——这是最常见的原因。

• 修复：全量替换DataFrame时，不要用dataChanged，改用模型重置方法：

def on_data_update(self, new_df):
    # 通知视图即将重置模型，清空缓存
    self.beginResetModel()
    self.df = new_df
    # 完成重置，视图会重新加载数据
    self.endResetModel()

beginResetModel()和endResetModel()是Qt专门设计的全量更新接口，会让视图彻底清理旧数据缓存，比全量dataChanged高效得多，也能避免内存堆积。

2. data()方法返回对象的重复创建 #

如果你的data()方法每次都返回新的Qt对象（比如QString、QBrush），而不是原生Python类型，会产生大量临时对象无法被及时回收。

• 修复：尽量返回原生Python类型，PySide6会自动转换为对应的Qt类型：

def data(self, index, role=Qt.DisplayRole):
    if not index.isValid():
        return None
    if role == Qt.DisplayRole:
        # 返回str/int等原生类型，而非QString
        return str(self.df.iloc[index.row(), index.column()])
    # 只处理必要的角色，避免额外开销
    return None

3. QTableView的视图缓存与配置冗余 #

QTableView默认的一些配置会增加内存开销，尤其是频繁更新时：

• 修复：
  • 开启统一行高：self.tableView.setUniformRowHeights(True)，减少视图对不同行高的缓存；
  • 关闭不必要的功能：如果表格是只读的，关闭编辑触发：self.tableView.setEditTriggers(QAbstractItemView.NoEditTriggers)；不需要排序就关闭排序：self.tableView.setSortingEnabled(False)；
  • 必要时手动清理缓存：配合模型重置，调用self.tableView.reset()。

4. 线程信号连接的引用泄漏 #

跨线程传递DataFrame时，默认的Qt.AutoConnection可能导致主线程持有旧DataFrame的引用无法释放。

• 修复：确保信号连接使用Qt.QueuedConnection（主线程处理Slot），且在Slot中不要额外持有旧DataFrame的引用：

# 在主线程初始化时连接信号
model_layer.signal_data_updated.connect(
    self.table_model.on_data_update,
    Qt.QueuedConnection
)

5. DataFrame的引用持有问题 #

如果更新self.df前，旧的DataFrame被模型的内部状态、信号槽引用持有，会导致GC无法回收。

• 修复：配合beginResetModel()/endResetModel()的调用，更新self.df时直接覆盖即可，不需要额外的copy（除非有线程安全需求）——模型重置会让视图释放对旧DataFrame的所有引用。

内容的提问来源于stack exchange，提问作者Rob M.