PyQt中QTreeWidgetItem重命名时的兄弟项唯一性校验问题

我明白你现在的困境：已经实现了名称格式校验，但在处理兄弟项重名时，用itemChanged信号会导致编辑失败和潜在的循环问题。下面我会给出两种可行的解决方案，其中第一种更符合Qt的MVC设计理念，推荐优先使用。

方法一：在ItemDelegate中统一处理校验（推荐） #

把格式校验和兄弟项冲突校验都放在QItemDelegate中，既符合职责分离，又能避免信号循环和编辑失败的问题。核心思路是在编辑器提交数据前，先完成所有校验，不通过就拒绝提交并重新打开编辑。

修改后的完整代码 #

import sys
from PyQt5.QtWidgets import QItemDelegate, QTreeWidget, QVBoxLayout, QLineEdit,\
QMainWindow, QWidget, QTreeWidgetItem, QApplication, QMessageBox
from PyQt5.QtCore import QRegExp, Qt, QTimer
from PyQt5.QtGui import QRegExpValidator

class TreeWidgetDelegate(QItemDelegate):
    def __init__(self, tree_widget, parent=None):
        super().__init__(parent)
        self.tree_widget = tree_widget  # 持有TreeWidget引用，用于获取兄弟项

    def createEditor(self, parent, option, index):
        editor = QLineEdit(parent)
        # 格式校验：仅允许字母、数字、[]、_、-
        reg = QRegExp('[A-z0-9\[\]_-]+')
        vd = QRegExpValidator(reg)
        editor.setValidator(vd)
        return editor

    def setModelData(self, editor, model, index):
        new_name = editor.text().strip()
        
        # 校验1：名称不能为空
        if not new_name:
            QMessageBox.warning(editor, "错误", "名称不能为空！")
            QTimer.singleShot(0, lambda: self.tree_widget.editItem(self.tree_widget.itemFromIndex(index)))
            return
        
        # 获取当前项和父项（顶级项的父项是TreeWidget的隐藏根节点）
        current_item = self.tree_widget.itemFromIndex(index)
        parent_item = current_item.parent() or self.tree_widget.invisibleRootItem()

        # 校验2：检查兄弟项是否重名
        for i in range(parent_item.childCount()):
            sibling_item = parent_item.child(i)
            if sibling_item != current_item and sibling_item.text(0) == new_name:
                QMessageBox.warning(editor, "错误", "该名称已存在于兄弟项中！")
                # 延迟打开编辑器，避免Qt内部状态冲突导致编辑失败
                QTimer.singleShot(0, lambda: self.tree_widget.editItem(current_item))
                return

        # 所有校验通过，提交新名称
        super().setModelData(editor, model, index)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        frame = QWidget()
        self.setCentralWidget(frame)
        hl = QVBoxLayout()
        frame.setLayout(hl)
        self.tree = QTreeWidget(self)
        
        # 初始化Delegate时传入TreeWidget引用
        mydele = TreeWidgetDelegate(self.tree)
        self.tree.setItemDelegate(mydele)
        hl.addWidget(self.tree)

        # 添加测试顶级项
        for ii in range(5):
            item = QTreeWidgetItem([str(ii),])
            self.tree.addTopLevelItem(item)

        self.tree.itemDoubleClicked.connect(self.rename)
        self.show()

    def rename(self):
        items = self.tree.selectedItems()
        if items:
            item = items[0]
            # 确保项处于可编辑状态
            if not (item.flags() & Qt.ItemIsEditable):
                item.setFlags(item.flags() | Qt.ItemIsEditable)
            self.tree.scrollToItem(item)
            self.tree.editItem(item)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    form = MainWindow()
    form.show()
    sys.exit(app.exec_())

关键说明 #

1. Delegate持有TreeWidget引用：这样可以轻松获取当前项的兄弟项，完成重名校验。
2. setModelData校验时机：这个方法是编辑器提交数据到模型的最后一步，在这里拦截校验，能避免无效数据写入项中。
3. QTimer.singleShot延迟编辑：直接调用editItem会因为Qt内部的编辑状态未清理而报错，延迟执行可以让Qt完成当前事件循环后再打开编辑器。

方法二：修复itemChanged信号的处理逻辑 #

如果你坚持使用itemChanged信号，需要解决信号循环和状态冲突问题，核心是在恢复旧值时暂时断开信号，避免触发重复校验。

修改后的核心代码片段 #

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # ... 其他初始化代码 ...
        self._current_edit_old_name = ""  # 保存编辑前的旧名称

    def rename(self):
        items = self.tree.selectedItems()
        if items:
            item = items[0]
            self._current_edit_old_name = item.text(0)  # 记录旧名称
            if not (item.flags() & Qt.ItemIsEditable):
                item.setFlags(item.flags() | Qt.ItemIsEditable)
            self.tree.scrollToItem(item)
            self.tree.editItem(item)

    def checkString(self, item, column):
        if column != 0:
            return  # 只处理第一列的名称修改

        new_name = item.text(column)
        parent_item = item.parent() or self.tree.invisibleRootItem()
        conflict = False

        # 检查兄弟项重名
        for i in range(parent_item.childCount()):
            sibling = parent_item.child(i)
            if sibling != item and sibling.text(0) == new_name:
                conflict = True
                break

        if conflict:
            # 暂时断开信号，避免恢复旧值时再次触发校验
            self.tree.itemChanged.disconnect(self.checkString)
            # 恢复旧名称
            item.setText(column, self._current_edit_old_name)
            # 重新连接信号
            self.tree.itemChanged.connect(self.checkString)
            # 延迟打开编辑器
            QTimer.singleShot(0, lambda: self.tree.editItem(item))
            QMessageBox.warning(self, "错误", "该名称已存在于兄弟项中！")

关键说明 #

• 保存旧名称：在进入编辑模式时记录旧值，冲突时可以快速恢复。
• 断开/重连信号：避免恢复旧值时触发itemChanged信号，导致无限循环。
• 延迟编辑：同样用QTimer避免Qt内部状态冲突。

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