多QTreeWidget单选异常：如何正确清除选中状态？

我来帮你拆解下这个问题的根源，再给出靠谱的实现方案：

问题出在哪？ #

你用的currentItemChanged信号有个局限性：只有当当前选中项发生变化时才会触发。当你第三步再次点击第一个QTreeWidget中已经选中过的同一行时，因为当前项没有改变，这个信号根本不会触发，导致你的清除选中状态的逻辑没执行，所以之前第二个QTreeWidget的选中状态就残留下来了。

正确的实现方案 #

我们换用更可靠的信号来监听选中行为，同时维护一个全局互斥逻辑，确保任何时候只有一个QTreeWidget能有选中项。推荐用itemSelectionChanged信号（只要选中状态有变动就触发，包括重复点击同一行的情况），配合统一的清除逻辑：

步骤1：头文件声明（mainwindow.h） #

添加全局变量记录当前选中的树部件，以及对应的槽函数和辅助函数：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QTreeWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    void handleTreeSelection(); // 统一处理所有树的选中事件

private:
    Ui::MainWindow *ui;
    QTreeWidget* m_activeTree = nullptr; // 记录当前有选中项的树部件
    void clearOtherTreeSelections(QTreeWidget* keepTree); // 清除除指定树外的所有选中状态
};
#endif // MAINWINDOW_H

步骤2：核心逻辑实现（mainwindow.cpp） #

绑定信号并编写互斥选中逻辑：

#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 给所有需要互斥的QTreeWidget绑定信号
    connect(ui->treeWidget1, &QTreeWidget::itemSelectionChanged, this, &MainWindow::handleTreeSelection);
    connect(ui->treeWidget2, &QTreeWidget::itemSelectionChanged, this, &MainWindow::handleTreeSelection);
    // 有更多树的话，继续添加对应的connect即可
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::handleTreeSelection()
{
    // 获取触发信号的树部件
    QTreeWidget* senderTree = qobject_cast<QTreeWidget*>(sender());
    if (!senderTree) return;

    // 清除其他所有树的选中状态
    clearOtherTreeSelections(senderTree);

    // 更新当前活跃的树部件
    m_activeTree = senderTree;
}

void MainWindow::clearOtherTreeSelections(QTreeWidget* keepTree)
{
    // 遍历窗口中所有QTreeWidget，清除非目标树的选中状态
    QList<QTreeWidget*> allTrees = findChildren<QTreeWidget*>();
    for (QTreeWidget* tree : allTrees) {
        if (tree != keepTree) {
            tree->clearSelection(); // 清除选中高亮
            tree->setCurrentItem(nullptr); // 彻底清除当前项标记，避免残留状态
        }
    }
}

为什么这个方案能解决问题？ #

1. 信号的可靠性：itemSelectionChanged不管是选中新行还是重复点击已选中的行，都会触发，完美覆盖你遇到的第三步场景；
2. 全局互斥逻辑：每次有树触发选中事件时，都会先清除其他所有树的选中状态，确保同一时间只有一个树能保留选中项；
3. 彻底清除状态：同时调用clearSelection()和setCurrentItem(nullptr)，避免只清除高亮但残留当前项标记的隐性问题。

额外小技巧 #

如果你的树部件数量固定，也可以直接指定互斥树列表（比如QList<QTreeWidget*> {ui->treeWidget1, ui->treeWidget2}），不用遍历所有子部件，效率会更高。

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