Python PyQt5中QListWidget添加条目时如何实现垂直滚动条自动下滑

最简实现方式 #

QListWidget内置了scrollToBottom()方法，直接在条目新增完成后调用即可，这是最高效的实现方案：

from PyQt5.QtWidgets import QListWidget, QListWidgetItem

# 假设你的QListWidget实例名为list_widget
# 1. 新增条目
list_widget.addItem("新添加的条目内容")
# 2. 调用方法自动滚动到底部
list_widget.scrollToBottom()

如果需要批量新增多个条目，只需要在所有条目添加完成后调用一次scrollToBottom()即可，无需每条新增后都调用，能减少不必要的界面渲染消耗。

滚动到指定新增条目 #

如果你不需要滚动到列表最底部，仅需要让刚新增的条目显示在可视区域内，可以使用scrollToItem()方法：

from PyQt5.QtWidgets import QListWidget, QListWidgetItem, QAbstractItemView

# 1. 创建条目实例
new_item = QListWidgetItem("指定新增的条目")
# 2. 添加到列表
list_widget.addItem(new_item)
# 3. 滚动到当前新增的条目位置，参数EnsureVisible表示保证条目完整显示在可视区域
list_widget.scrollToItem(new_item, QAbstractItemView.ScrollHint.EnsureVisible)

注意事项 #

• 所有界面操作（包括新增条目、调用滚动方法）必须在主线程中执行，如果你在子线程中处理数据后需要新增条目，要通过信号槽机制将操作抛到主线程执行，否则会出现滚动失效、界面崩溃等问题
• 若QListWidget开启了自动排序功能，需要等排序逻辑执行完成后再调用滚动方法，否则可能滚动到错误位置

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