QListView填充数据后水平滚动条不显示，如何修复？

你遇到的问题根源确实是把sizeHint固定成了图标尺寸——这会让QListView误以为每个列表项的宽度就等于图标宽度，哪怕文本内容远超图标宽度，视图也只会直接截断文本，不会判定内容超出了部件宽度，自然就不会触发水平滚动条了。给你几个针对性的解决办法：

1. 用正确方式控制图标大小 #

别在sizeHint里硬写图标尺寸来控制图标大小，直接用QListView自带的方法就能精准控制：

listView = QtGui.QListView()
# 直接设置图标尺寸，不影响项的宽度计算
listView.setIconSize(QtCore.QSize(18, 18))

这种方式既能保证图标大小符合预期，又不会限制列表项的宽度，文本内容的宽度会被正常计算。

2. 正确重写sizeHint（如果必须自定义） #

如果你确实需要重写sizeHint，得把图标宽度+文本宽度+间距一起算进去，而不是只返回图标尺寸。修改你的Model代码：

def sizeHint(self, index):
    if not index.isValid():
        return QtCore.QSize()
    
    # 获取当前项的文本内容
    text = self.data(index, QtCore.Qt.DisplayRole)
    # 计算文本所需的宽度
    font_metrics = QtGui.QFontMetrics(self.parent().font() if self.parent() else QtGui.QFont())
    text_width = font_metrics.width(text)
    
    # 总宽度 = 图标宽度 + 文本宽度 + 左右间距（可根据需求调整）
    total_width = self._iconSize.width() + text_width + 8
    # 高度沿用图标高度即可
    return QtCore.QSize(total_width, self._iconSize.height())

3. 配置滚动条和视图的resize策略 #

最后别忘了给QListView设置合适的滚动条规则和视图调整模式：

# 滚动条按需显示（也可以设为ScrollBarAlwaysOn强制显示）
listView.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarAsNeeded)
# 让视图根据内容自动调整项的宽度
listView.setResizeMode(QtGui.QListView.AdjustToContents)

这样调整后，当列表项的总宽度超过QListView的部件宽度时，水平滚动条就会正常显示并支持滚动了。

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