QTreeView绑定QFileSystemModel时顶层项选中异常及重复调用问题咨询

问题2：为何未访问过的目录对应的QModelIndex的model属性为NoneType？ #

这是因为QFileSystemModel是异步延迟加载的：当你调用setRootPath后，模型并不会立即完成目录内容的加载，而是在后台线程中处理加载操作。此时通过model.index(0, 0, self.rootIndex())获取的索引是一个临时无效索引，它还没有真正关联到模型实例，所以调用model()会返回None。只有当目录加载完成（触发directoryLoaded信号）后，对应的索引才会变成有效索引，model()才会返回正确的QFileSystemModel对象。

问题1：如何在不重复调用set_directory方法的前提下，实现Treeview当前索引自动选中顶层项？ #

核心思路是把「设置根路径」和「选中顶层项」的逻辑拆分开：让set_directory只负责设置根路径，而「选中顶层项」的操作作为单独的槽函数，绑定到model.directoryLoaded信号上。这样既避免了循环调用，又能在目录真正加载完成后再去操作有效索引。

修改后的完整代码如下：

from PyQt5.QtWidgets import QPushButton, QTreeView, QFileSystemModel, QWidget, QFileDialog, QApplication, QHBoxLayout
import sys

class Treeview(QTreeView):
    def __init__(self, parent=None):
        super(QTreeView, self).__init__(parent)
        self.model = QFileSystemModel()
        self.setModel(self.model)
        # 绑定目录加载完成信号到单独的选中逻辑槽函数
        self.model.directoryLoaded.connect(self._select_top_item)
        self.set_directory(".")

    def set_directory(self, path):
        # 仅负责设置根路径，不处理选中逻辑
        self.setRootIndex(self.model.setRootPath(path))

    def _select_top_item(self, path):
        # 仅当加载完成的目录是当前根目录时，才执行选中操作
        if self.model.rootPath() == path:
            top_index = self.model.index(0, 0, self.rootIndex())
            self.setCurrentIndex(top_index)
            print(type(top_index.model()))  # 现在会正常输出<class 'PyQt5.QtWidgets.QFileSystemModel'>

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super(QWidget, self).__init__(parent)
        self.tview = Treeview(self)
        vlayout = QHBoxLayout(self)
        vlayout.addWidget(self.tview)
        open_button = QPushButton("选择目录", self)
        open_button.clicked.connect(self.open_dir)
        vlayout.addWidget(open_button)

    def open_dir(self):
        filepath = QFileDialog.getExistingDirectory(self)
        if filepath:
            self.tview.set_directory(filepath)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    widget = MainWidget()
    widget.show()
    sys.exit(app.exec_())

关键修改说明： #

1. 逻辑拆分：将原set_directory中的选中逻辑移到新的_select_top_item方法中，让set_directory只专注于设置根路径，避免了信号触发的循环调用。
2. 信号绑定优化：仅把_select_top_item绑定到directoryLoaded信号，确保只有目录加载完成后才执行选中操作，此时获取的索引是有效的。
3. 路径校验：在_select_top_item中增加了路径匹配判断，避免快速切换目录时，旧目录的延迟加载信号干扰当前目录的选中操作。

这样修改后，无论是首次打开默认目录，还是通过按钮选择新目录，都能正确选中顶层项，同时不会出现set_directory重复调用的问题，控制台输出也会正常显示模型类型。

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