在 Python 中，使用 PyQt 实现搜索并展示指定文件夹路径的目录结构可以通过 `QTreeWidget` 或 `QFileSystemModel` 与 `QTreeView` 结合来实现。以下是一种基于 `QFileSystemModel` 的实现方式，它能够高效地加载和显示目录结构，并支持展开和折叠节点。 ### 使用 PyQt5 显示目录结构 首先需要导入必要的模块，然后创建模型和视图对象： ```python from PyQt5.QtWidgets import QApplication, QTreeView, QWidget, QVBoxLayout, QPushButton, QFileDialog from PyQt5.QtCore import QDir class DirectoryViewer(QWidget): def __init__(self): super().__init__() self.setWindowTitle("目录结构查看器") self.setGeometry(100, 100, 600, 400) layout = QVBoxLayout(self) self.tree_view = QTreeView() self.model = QFileSystemModel() self.model.setRootPath(QDir.rootPath()) self.tree_view.setModel(self.model) layout.addWidget(self.tree_view) self.button = QPushButton("选择文件夹") self.button.clicked.connect(self.select_directory) layout.addWidget(self.button) def select_directory(self): directory = QFileDialog.getExistingDirectory(self, "选择文件夹") if directory: index = self.model.index(directory) self.tree_view.setRootIndex(index) app = QApplication([]) viewer = DirectoryViewer() viewer.show() app.exec_() ``` ### 功能说明 - **QFileSystemModel**：这是 Qt 提供的一个用于访问本地文件系统的模型类，支持目录和文件的浏览。 - **QTreeView**：用于显示树状结构数据，配合 `QFileSystemModel` 可以展示完整的目录结构。 - **QFileDialog.getExistingDirectory**：打开一个对话框让用户选择文件夹路径[^4]。 ### 扩展功能建议 - 支持过滤特定类型的文件（如只显示 `.txt` 文件）。 - 添加右键菜单，支持刷新、复制路径等操作。 - 高亮当前选中的文件或文件夹。 - 支持拖放操作将文件拖入其他组件中进行处理。 ### 性能优化 - 对于大型目录结构，可以考虑限制递归深度或使用异步加载机制避免界面卡顿。 - 启用排序功能以便用户更方便地查找文件。 ---