You need to enable JavaScript to run this app. PyQt5 QTreeView中如何完全隐藏文件夹仅显示文件
优惠活动
大模型
产品
解决方案
定价
更多

PyQt5 QTreeView中如何完全隐藏文件夹仅显示文件

QTreeView 隐藏所有文件夹仅展示文件的实现方案

核心问题原因

QFileSystemModel自带的NameFilters仅对文件类型条目生效,所有文件夹条目会被默认渲染,且没有内置开关可以直接全局隐藏文件夹,需要通过代理模型拦截行数据实现过滤。

具体实现步骤

  • 第一步:自定义继承自QSortFilterProxyModel的代理过滤类,重写行过滤规则
    代理模型会作为中间层插在源文件系统模型和树视图之间,逐行判断条目类型,直接过滤掉所有文件夹类条目。
    对应代码:
    from PyQt5.QtCore import QSortFilterProxyModel, QModelIndex
    from PyQt5.QtWidgets import QFileSystemModel
    
    class FileOnlyProxyModel(QSortFilterProxyModel):
        def filterAcceptsRow(self, source_row: int, source_parent: QModelIndex) -> bool:
            # 获取源模型对应行的条目索引
            source_index = self.sourceModel().index(source_row, 0, source_parent)
            # 判断条目是否为文件夹
            if self.sourceModel().fileInfo(source_index).isDir():
                # 是文件夹则直接过滤,不展示
                return False
            # 剩余文件条目走原有过滤逻辑,兼容之前设置的文件类型筛选规则
            return super().filterAcceptsRow(source_row, source_parent)
    
  • 第二步:调整原有视图与模型的绑定逻辑
    不再直接将QFileSystemModel绑定到QTreeView,改为先将文件系统模型绑定到自定义代理模型,再将代理模型绑定到视图;同时需要将源模型的根索引映射为代理模型的对应索引,避免视图加载异常。
    对应代码:
    # 保留原有QFileSystemModel初始化逻辑
    self.model = QFileSystemModel()
    self.model.setRootPath(self.dirPath)
    # 原有配置的文件类型过滤规则可完全保留,不会与代理逻辑冲突
    # self.model.setNameFilters(["*.txt", "*.jpg"])
    # self.model.setNameFilterEnabled(True)
    
    # 初始化自定义代理模型
    self.proxy_model = FileOnlyProxyModel()
    self.proxy_model.setSourceModel(self.model)
    
    # 树视图绑定代理模型,代替原有的直接绑定源模型逻辑
    self.tree.setModel(self.proxy_model)
    
    # 根索引做代理映射,保证视图路径正确
    root_source_idx = self.model.index(os.getcwd())
    root_proxy_idx = self.proxy_model.mapFromSource(root_source_idx)
    self.tree.setRootIndex(root_proxy_idx)
    

注意事项

  • 该逻辑会全局过滤所有层级的文件夹条目,最终视图只会展示指定根路径下的所有文件,无目录树层级结构
  • 代理模型的过滤逻辑是后置的,不会破坏QFileSystemModel原有的文件类型筛选、文件信息展示等功能
  • 不要遗漏根索引的映射步骤,直接将源模型索引传给setRootIndex会导致视图无法加载正确目录

内容的提问来源于stack exchange,提问作者Cnewbiec

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 06:06:04