如何在PyQt5的QTreeView中实现仅按住Ctrl键时启用多选

这个需求我之前做项目时也碰到过，默认的MultiSelection确实会让点击直接选中多个项，完全不符合咱们要的“仅Ctrl触发多选”的预期。这里有两种实用方案，你可以根据需求选：

方案一：用Qt内置的ExtendedSelection模式（最简单） #

其实Qt早就给咱们准备好对应的模式了——QAbstractItemView.ExtendedSelection，它的行为正好匹配你的需求：

• 正常点击项：自动取消之前所有选中，只选当前项（单选逻辑）
• 按住Ctrl点击项：切换当前项的选中状态（已选中的取消，未选中的添加），其他选中项保持不变
• （可选）按住Shift点击：选中从上次选中项到当前项的连续范围（如果不需要这个功能，再看方案二）

只需要把你原来的代码改成这样就行：

self.tree_view.setSelectionMode(QAbstractItemView.ExtendedSelection)

这个方案不用写额外逻辑，完全靠Qt内置行为实现，推荐优先用它。

方案二：自定义选择逻辑（严格屏蔽Shift，仅Ctrl生效） #

如果你需要彻底屏蔽Shift的连续选择功能，只允许Ctrl触发多选，可以继承QTreeView重写鼠标点击事件来实现：

from PyQt5.QtWidgets import QTreeView, QAbstractItemView
from PyQt5.QtGui import QMouseEvent
from PyQt5.QtCore import Qt

class CtrlOnlyMultiTreeView(QTreeView):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 默认设置为单选模式
        self.setSelectionMode(QAbstractItemView.SingleSelection)
        
    def mousePressEvent(self, event: QMouseEvent):
        # 判断是否按住了Ctrl键
        if event.modifiers() & Qt.ControlModifier:
            # 临时切换到多选模式，允许添加选中项
            self.setSelectionMode(QAbstractItemView.MultiSelection)
            # 让父类处理点击的选中逻辑
            super().mousePressEvent(event)
            # 立刻切回单选模式，保证下次正常点击还是单选
            self.setSelectionMode(QAbstractItemView.SingleSelection)
        else:
            # 没按Ctrl，正常执行单选逻辑
            super().mousePressEvent(event)

之后用这个自定义控件代替原来的QTreeView就可以了：

self.tree_view = CtrlOnlyMultiTreeView()
# 其他初始化代码（比如设置模型、列宽等）...

这个方案的核心是“临时切换选择模式”——按住Ctrl点击时短暂开启多选，处理完点击立刻切回单选，既实现了Ctrl加选，又保证了正常点击的单选逻辑，同时彻底屏蔽了Shift的连续选择。

补充小提示 #

如果还需要处理方向键的选择逻辑，你可以同样重写keyPressEvent，用类似的方式判断Ctrl键状态来调整选择模式，逻辑和鼠标点击是一致的。

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