嘿，我完全懂你在Windows上用QTreeView+QFileSystemModel时遇到的默认图标糟心问题——原生图标确实有时候不够好看或者不符合需求。把C++里重写QFileIconProvider的逻辑转成Python其实一点都不难，我给你手把手捋清楚怎么实现：

1. 继承QFileIconProvider并重写核心方法 #

我们需要创建一个自定义类继承自QFileIconProvider，然后重写它的icon()方法——这个方法负责返回对应文件/文件夹/驱动器的图标，它有两种参数类型需要处理：系统预设的图标类型（比如文件夹、普通文件），以及具体的QFileInfo对象（用来判断更细节的类型，比如网络驱动器）。

from PyQt5 import QtGui, QtWidgets, QtCore
# 如果你用PyQt6，注意模块调整：from PyQt6 import QtGui, QtWidgets, QtCore

class CustomIconProvider(QtGui.QFileIconProvider):
    def __init__(self):
        super().__init__()
        # 提前加载所有需要的自定义图标，避免重复读取文件拖慢性能
        self.custom_folder_icon = QtGui.QIcon("assets/custom_folder.png")
        self.network_drive_icon = QtGui.QIcon("assets/network_drive.png")
        # 可以根据需求添加更多，比如txt文件图标、图片文件图标等

    def icon(self, target):
        # 处理系统预设的图标类型（比如Folder、File、Drive等）
        if isinstance(target, QtGui.QFileIconProvider.IconType):
            if target == QtGui.QFileIconProvider.Folder:
                return self.custom_folder_icon
            # 其他系统类型可以返回默认图标，或者自己自定义
            return super().icon(target)
        
        # 处理具体的文件/文件夹/驱动器信息（QFileInfo对象）
        elif isinstance(target, QtCore.QFileInfo):
            file_info = target
            # 判断是否是网络驱动器：Windows下这个方法能准确识别共享驱动器
            if file_info.isDir() and file_info.isNetworkDrive():
                return self.network_drive_icon
            elif file_info.isDir():
                return self.custom_folder_icon
            # 如果需要自定义文件图标，这里可以根据后缀判断：
            # elif file_info.suffix().lower() == "txt":
            #     return self.txt_icon
            # 默认返回系统图标
            return super().icon(file_info)
        
        # 兜底返回系统默认图标
        return super().icon(target)

2. 绑定自定义Provider到FileSystemModel #

接下来把这个自定义的图标提供者设置给你的QFileSystemModel，再关联到QTreeView上就可以了：

class DirectoryTreeWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("自定义图标目录树")
        self.resize(800, 600)

        # 初始化文件系统模型
        self.file_model = QtWidgets.QFileSystemModel()
        # 设置根目录，这里用当前程序运行目录，你可以改成自己需要的路径
        root_dir = QtCore.QDir.currentPath()
        self.file_model.setRootPath(root_dir)

        # 绑定自定义图标提供者
        self.icon_provider = CustomIconProvider()
        self.file_model.setIconProvider(self.icon_provider)

        # 初始化TreeView并关联模型
        self.tree_view = QtWidgets.QTreeView()
        self.tree_view.setModel(self.file_model)
        # 设置根索引，让TreeView从指定目录开始显示
        self.tree_view.setRootIndex(self.file_model.index(root_dir))

        # 优化显示：只保留名称列，调整列宽
        self.tree_view.hideColumn(1)
        self.tree_view.hideColumn(2)
        self.tree_view.hideColumn(3)
        self.tree_view.setColumnWidth(0, 400)

        self.setCentralWidget(self.tree_view)

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    window = DirectoryTreeWindow()
    window.show()
    sys.exit(app.exec_())

3. 几个关键注意点 #

• 图标路径：确保自定义图标的路径正确，建议用项目内的相对路径或者绝对路径，避免程序找不到图标
• PyQt版本兼容：如果用PyQt6，QFileIconProvider从QtGui移到了QtWidgets模块里，记得修改导入语句
• 扩展自定义范围：如果需要给特定类型文件（比如PDF、Excel）加自定义图标，只需要在icon()方法里通过file_info.suffix()判断后缀名，返回对应的图标即可
• 性能优化：提前在__init__里加载所有需要的图标，不要在icon()方法里每次读取文件，不然频繁调用时会卡顿

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