PyQt：QListWidget是否存在setCurrentItems批量选中项的方法？

嘿，我刚好折腾过这个需求！QListWidget确实没有内置的setCurrentItems()方法来直接批量选中多个项，但咱们可以通过简单的几步来实现这个功能，很容易搞定～

首先要明确一个前提：QListWidget默认是单选模式，所以不管你怎么调用选中方法，都只能选一个项。所以第一步必须先把选择模式改成支持多选的类型，否则批量选中根本不会生效。

第一步：设置多选模式 #

你可以根据需求选择以下几种多选模式：

• QListWidget.MultiSelection：点击就能选中/取消选中任意项，不需要按住快捷键
• QListWidget.ExtendedSelection：按住Ctrl键可以多选单个项，按住Shift键可以选中连续范围的项（和系统文件管理器的多选逻辑一致）
• QListWidget.ContiguousSelection：只能选中连续范围的项（通过Shift+点击）

设置代码很简单：

my_list_widget.setSelectionMode(QListWidget.MultiSelection)

第二步：实现批量选中的逻辑 #

接下来就可以实现批量选中了，这里提供两种常用的方式：

方式1：直接遍历项设置选中状态 #

这种方式直观易懂，适合大多数场景：

from PyQt5.QtWidgets import QListWidget, QListWidgetItem
from PyQt5.QtCore import Qt

def batch_select_items(list_widget, target_items):
    # 先确保多选模式已开启
    if list_widget.selectionMode() not in [QListWidget.MultiSelection, QListWidget.ExtendedSelection]:
        list_widget.setSelectionMode(QListWidget.MultiSelection)
    
    # 可选：清除当前已选中的项（如果需要覆盖原有选中状态的话）
    list_widget.clearSelection()
    
    for item in target_items:
        # 支持传入项文本或者QListWidgetItem对象
        if isinstance(item, str):
            # 根据文本查找项，这里假设文本唯一，取第一个匹配项
            found_items = list_widget.findItems(item, Qt.MatchExactly)
            if found_items:
                found_items[0].setSelected(True)
        else:
            item.setSelected(True)

使用示例：

# 假设你已经创建了QListWidget实例并添加了项
my_list = QListWidget()
for data in ['data1', 'data2', 'data3', 'data4']:
    my_list.addItem(QListWidgetItem(data))

# 方式A：传入QListWidgetItem对象列表
items_to_select = [my_list.findItems('data2', Qt.MatchExactly)[0], my_list.findItems('data4', Qt.MatchExactly)[0]]
batch_select_items(my_list, items_to_select)

# 方式B：直接传入项文本列表
# batch_select_items(my_list, ['data2', 'data4'])

方式2：通过选择模型（QItemSelectionModel）操作 #

如果需要更精细的选中控制（比如添加选中、移除选中、切换选中状态），可以直接操作QListWidget的选择模型，这种方式更高效，适合大量项的场景：

from PyQt5.QtCore import QItemSelectionModel

def batch_select_items(list_widget, target_items):
    if list_widget.selectionMode() not in [QListWidget.MultiSelection, QListWidget.ExtendedSelection]:
        list_widget.setSelectionMode(QListWidget.MultiSelection)
    
    selection_model = list_widget.selectionModel()
    selection_model.clearSelection()  # 清除原有选中
    
    for item in target_items:
        if isinstance(item, str):
            found_items = list_widget.findItems(item, Qt.MatchExactly)
            if not found_items:
                continue
            target_item = found_items[0]
        else:
            target_item = item
        
        # 获取项对应的模型索引
        item_index = list_widget.indexFromItem(target_item)
        # 执行选中操作（QItemSelectionModel.Select表示添加到选中集合）
        selection_model.select(item_index, QItemSelectionModel.Select)

关键注意点 #

• 如果不设置多选模式，所有批量选中的操作都会无效，因为默认单选模式下只能有一个选中项
• 使用findItems查找项时，如果有重复的文本，需要额外处理（比如遍历所有匹配项），上面的示例假设文本是唯一的
• setSelected(True)只会改变项的选中状态，不会改变当前焦点项；如果需要同时把焦点移到某个项，可以搭配调用list_widget.setCurrentItem(item)

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