PyQt5中QTreeView展开项失效问题及文档解读咨询

问题根源 #

你的问题核心在于QFileSystemModel是异步加载目录数据的：初始化时调用setRootPath()后，模型不会立刻完成目标目录的全量扫描，而是在后台逐步加载子目录信息。此时直接调用expand()、setExpanded()或expandAll()，模型尚未获取到足够的子项数据，导致展开方法无效，或仅能展开已加载的第一层目录。

文档正确解读 #

QTreeView的expand()、setExpanded()方法确实用于展开指定索引的项，但文档隐含的前提是：模型已经加载了该索引对应的子项数据。对于QFileSystemModel这类异步模型，必须等待目标目录加载完成后，这些方法才能正常工作。

解决方案 #

通过QFileSystemModel的directoryLoaded信号监听目录加载状态，在目标目录加载完成后再执行展开操作：

修改后的代码 #

from PyQt5.QtWidgets import *
from PyQt5.QtCore import QModelIndex

class GUI(QWidget):
    def __init__(self, parent=None):
        super(GUI, self).__init__(parent)

        path = "C:/TEMP"
        self.model = QFileSystemModel()
        self.model.setRootPath(path)

        self.view = QTreeView()
        self.view.setModel(self.model)
        self.view.setRootIndex(self.model.index(path))

        self.but_1 = QPushButton("BUT 1")
        self.but_2 = QPushButton("BUT 2")

        self.V_layout = QVBoxLayout()
        self.V_layout.addWidget(self.view)
        self.V_layout.addWidget(self.but_1)
        self.V_layout.addWidget(self.but_2)
        self.setLayout(self.V_layout)

        # 存储需要展开的目标路径与索引
        self.target_paths = {
            "C:/TEMP": self.model.index(path),
            "C:/TEMP/bbbbb": self.model.index("C:/TEMP/bbbbb")
        }

        self.but_1.clicked.connect(lambda: self.expand_target("C:/TEMP"))
        self.but_2.clicked.connect(lambda: self.expand_target("C:/TEMP/bbbbb"))

        # 监听目录加载完成信号，初始化时触发根目录展开
        self.model.directoryLoaded.connect(self.on_directory_loaded)
        # 主动触发根目录加载
        self.model.index(path)

    def on_directory_loaded(self, path):
        # 目录加载完成后展开当前目录
        index = self.model.index(path)
        if index.isValid():
            self.view.expand(index)
            # 递归触发子目录加载，实现深度展开
            for row in range(self.model.rowCount(index)):
                child_index = self.model.index(row, 0, index)
                if self.model.isDir(child_index):
                    self.model.index(self.model.filePath(child_index))

    def expand_target(self, path):
        index = self.target_paths.get(path)
        if not index.isValid():
            index = self.model.index(path)
            self.target_paths[path] = index
        # 触发目标目录加载（若未加载），再执行展开
        if self.model.isDir(index):
            self.model.index(path)
            self.view.setExpanded(index, True)

if __name__ == "__main__":
    import sys
    app = QApplication(sys.argv)
    g = GUI()
    g.show()
    sys.exit(app.exec_())

关键说明 #

1. directoryLoaded信号：每次目录加载完成后触发，此时执行展开操作能确保模型已获取子项数据，解决异步加载导致的方法无效问题。
2. 递归深度展开：在on_directory_loaded中遍历子目录并触发加载，可实现逐层深度展开所有文件夹的需求。
3. 按钮触发逻辑：点击按钮时先校验索引有效性，主动触发目标目录加载后再执行展开，确保操作可靠生效。

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