QListView不显示表头：自定义QAbstractTableModel的headerData未被调用

第一优先级排查：确认当前使用的视图组件 #

QListView从组件设计上就没有内置表头渲染模块，它的渲染逻辑面向单列列表场景，完全不会主动调用模型的headerData()接口。哪怕你实现的模型是继承QAbstractTableModel写的，也不会自动适配出表头效果。
从你贴的启动日志看，columnCount()返回1、rowCount()返回0的阶段，完全没有触发headerData()的调用，这完全符合QListView的运行特征——如果用错了视图组件，不管模型层逻辑写得多么正确，都不会出现表头、也不会走到headerData()的实现里。如果需要显示表头，需要把当前的QListView替换为QTableView。

针对已确认使用QTableView场景的逐层排查 #

• 检查表头控件的显隐状态：QTableView默认是显示水平表头的，如果存在手动调用horizontalHeader()->setVisible(false)、全局样式表把QHeaderView设置为隐藏、或者在Designer里手动关掉了表头可见性的配置，会直接导致表头控件不渲染，自然不会发起headerData()的请求。
• 确认模型和视图的绑定时机：如果模型实例创建完成、列结构填充完毕之后，没有正确通过setModel()接口绑定到视图，或者绑定后没有触发模型重置信号通知视图刷新，视图会一直保持初始空状态，不会遍历各个列的section拉取表头数据。
• 排除你怀疑的rowCount()逻辑问题：哪怕rowCount()返回0，只要columnCount()返回值大于0，QTableView正常状态下也会渲染表头，表头显示完全和行数量没有绑定关系，不存在“没有行就不显示表头”的逻辑。
• 检查模型的信号通知逻辑：如果你在模型构造完成、把columns列结构填充好之后，没有在变更前后调用beginResetModel()/endResetModel()信号通知视图重新拉取全量的行、列、表头信息，视图会停留在初次初始化的状态，不会主动发起headerData()的调用。

快速定位验证方法 #

在你自定义的headerData()函数最开头去掉所有判断逻辑，直接返回硬编码的QString("test header")做测试：

• 如果此时还是没有看到对应日志打印、也没看到表头，基本可以确定是视图组件不对（误用了QListView），或者表头被手动隐藏了
• 如果此时能看到日志、也能看到表头，就回头检查你原来的判断条件里有没有把正确的表头数据过滤掉

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