QSortFilterProxyModel：beginFilterChange()/endFilterChange()的正确用法？

核心结论 #

可以直接将源模型的headerDataChanged信号连接到代理模型的自定义方法中，在方法内依次调用beginFilterChange()和endFilterChange(QtCore.QSortFilterProxyModel.Direction.Columns)，这个调用顺序完全合理，无需自行实现headerDataAboutToChange信号。

详细说明 #

1. 调用顺序的合理性
   beginFilterChange()用于通知代理模型：过滤规则即将发生变更；endFilterChange()则确认变更完成，并触发代理模型重新计算过滤逻辑、更新视图。在headerDataChanged信号触发后（即表头数据已完成更新）调用这两个方法，刚好能让代理模型基于新的表头数据重置列过滤器，达到“原有列过滤器失效”的效果，完全符合Qt文档对这两个替代方法的使用要求。

2. 是否需要自定义信号
   QAbstractItemModel没有提供headerDataAboutToChange信号是因为大部分场景下，表头数据变化后的通知已经足够。只有当你需要在表头数据尚未变更时执行一些预处理操作（比如临时保存原有过滤状态），才需要自行实现该信号。仅针对“表头变化让列过滤器失效”这个需求，使用现有的headerDataChanged信号就足够。

示例代码（PySide6） #

from PySide6 import QtCore

class CustomSortFilterProxyModel(QtCore.QSortFilterProxyModel):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 连接源模型的表头变化信号
        self.sourceModel().headerDataChanged.connect(self._on_header_changed)

    def _on_header_changed(self, logical_idx, orientation, role):
        # 仅处理水平表头（列表头）的变化
        if orientation == QtCore.Qt.Horizontal:
            self.beginFilterChange()
            self.endFilterChange(QtCore.QSortFilterProxyModel.Direction.Columns)

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