QTreeWidget findItems始终返回空，如何实现隐藏列搜索？

问题描述 #

我有一个最多包含30个项、深度最多为2的QTreeWidget树形控件，尝试在第二列（已隐藏）中查找特定项，但即使目标字符串肯定存在，findItems方法始终返回空列表。

排查后发现：树形控件的columnCount()为1，从树形控件的角度看不存在第二列，导致搜索失败。QTreeWidgetItem的构造函数传入的字符串列表会设置为项各列的文本，但项的列是否有效，取决于树形控件本身的列数设置。

实际需求是为每个项添加一个隐藏的已知ID，用于搜索（避免依赖可修改的文本或索引，因为代码支持排序）。

最小可复现示例：

from PyQt6.QtCore import Qt
from PyQt6.QtWidgets import QApplication, QTreeWidget, QTreeWidgetItem, QDialog, QVBoxLayout, QLabel
import sys

app = QApplication([])

main = QDialog()
main.setLayout(QVBoxLayout())

tree = QTreeWidget()
QTreeWidgetItem(tree, ['Test', 'test'])
main.layout().addWidget(tree)

label = QLabel()
main.layout().addWidget(label)

found = tree.findItems('test', Qt.MatchFlag.MatchRecursive | Qt.MatchFlag.MatchFixedString, 1)
label.setText(f'Found {len(found)} item(s)')

main.show()
sys.exit(app.exec())

补充：添加tree.setColumnCount(2)后搜索正常，但会显示想要隐藏的列，希望绕过findItems仅在可见列生效的限制。

解决方案 #

方法1：设置列宽为0隐藏列 #

设置树形控件列数为2后，直接将第二列宽度设为0，用户无法看到该列，但findItems仍能正常识别：

tree.setColumnCount(2)
tree.setColumnWidth(1, 0)  # 隐藏第二列

该方法最简单，适配你的小数据量场景，无需修改原有查找逻辑。

方法2：使用ItemDataRole存储自定义ID #

不依赖列，通过setData给每个项绑定自定义ID，再手动遍历树形控件查找：

# 添加项时存储ID
item = QTreeWidgetItem(tree, ['Test'])
# 用UserRole存储自定义ID，避免和系统内置数据冲突
item.setData(0, Qt.ItemDataRole.UserRole, 'test')

# 自定义查找函数（适配最多2层深度）
def find_item_by_id(tree_widget, target_id):
    found = []
    # 遍历顶层项
    for top_idx in range(tree_widget.topLevelItemCount()):
        top_item = tree_widget.topLevelItem(top_idx)
        if top_item.data(0, Qt.ItemDataRole.UserRole) == target_id:
            found.append(top_item)
        # 遍历子项
        for child_idx in range(top_item.childCount()):
            child_item = top_item.child(child_idx)
            if child_item.data(0, Qt.ItemDataRole.UserRole) == target_id:
                found.append(child_item)
    return found

# 执行查找
found = find_item_by_id(tree, 'test')
label.setText(f'Found {len(found)} item(s)')

这种方式更灵活，适合需要存储多组自定义数据的场景，完全脱离列的限制。

方法3：重写QTreeWidget的findItems（不推荐） #

若坚持使用原生findItems，可重写QTreeWidget的findItems方法，使其支持查找隐藏数据，但该方式冗余，前两种方法已足够高效。

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