PyQt6：如何通过路径在QTreeWidget中定位并选中元素

需求说明 #

需通过路径字符串（示例：parent/parent/parent/parent/element）在QTreeWidget中定位并选中元素，由于树中可能存在同名元素，必须按完整路径层级匹配。

尝试的代码 #

用户最初实现的代码：

def find_and_select_item(self):
    path = self.comboBox_Scene.currentText()
    path_elements = path.split('/')
    current_item = self.treeWidget.invisibleRootItem()
    for element in path_elements:
        items = self.treeWidget.findItems(element, Qt.MatchFlag, 0)
        if items:
            current_item = items[0]
        else:
            # 当前层级未找到元素
            return None

    # 选中找到的元素
    current_item.setSelected(True)
    return current_item

报错信息 #

运行时触发错误：

TypeError: findItems(self, text: str, flags: Qt.MatchFlag, column: int = 0): argument 2 has unexpected type 'EnumType'

问题分析与修复方案 #

错误原因 #

1. Qt.MatchFlag是枚举类，不能直接作为参数传入findItems，必须传入具体的枚举值（如Qt.MatchExactly）；
2. 原代码用treeWidget.findItems会在整个树中搜索，无法实现按路径层级逐步匹配，很容易选中错误的同名元素。

修复后的代码 #

正确的实现应该逐层遍历当前节点的子节点，严格按路径层级匹配：

def find_and_select_item(self):
    path = self.comboBox_Scene.currentText()
    path_elements = path.split('/')
    current_item = self.treeWidget.invisibleRootItem()
    
    for element in path_elements:
        found = False
        # 只在当前节点的子节点中查找，确保层级匹配
        for i in range(current_item.childCount()):
            child = current_item.child(i)
            if child.text(0) == element:
                current_item = child
                found = True
                break
        if not found:
            # 当前层级没找到对应元素，返回None
            return None
    
    # 选中目标节点
    self.treeWidget.setCurrentItem(current_item)
    current_item.setSelected(True)
    # 可选：让节点滚动到视图可见区域
    self.treeWidget.scrollToItem(current_item)
    return current_item

关键改进点 #

• 改用逐层遍历子节点的方式，完全符合路径层级匹配要求，避免跨层级匹配同名元素；
• 直接对比节点文本，逻辑更直观，同时规避了findItems的枚举参数错误；
• 添加scrollToItem确保选中的节点能在视图中显示（可选功能）；
• 保留了路径匹配失败时返回None的逻辑，方便后续错误处理。

如果一定要用findItems，需传入具体枚举值（比如Qt.MatchExactly），但这种方式不适合路径层级匹配场景，因此更推荐上述逐层遍历的方案。

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