QTableWidget排序问题：如何让文件夹始终排在文件上方？

要实现文件夹优先排序（无论升序/降序都让文件夹在文件前面），你需要自定义排序逻辑——默认的字符串排序只会按文件名/文件夹名的ASCII码排序，无法区分类型优先级。下面提供两种常用的实现方式，你可以根据自己的场景选择：

方法一：自定义QTableWidgetItem并重写<运算符 #

这种方式适合直接使用QTableWidgetItem管理数据的场景，通过重写比较逻辑让文件夹拥有更高的排序优先级。

步骤1：创建自定义Item类 #

继承QTableWidgetItem，重写operator<方法，先判断类型再比较名称：

#include <QTableWidgetItem>

class CustomFolderItem : public QTableWidgetItem {
public:
    // 继承父类的构造函数
    using QTableWidgetItem::QTableWidgetItem;

    bool operator<(const QTableWidgetItem& other) const override {
        // 通过自定义角色获取当前item是否为文件夹（提前设置好数据）
        bool isThisFolder = data(Qt::UserRole).toBool();
        bool isOtherFolder = other.data(Qt::UserRole).toBool();

        // 类型不同时，文件夹优先排在前面
        if (isThisFolder != isOtherFolder) {
            // 给文件夹设置更低的优先级数值（0），文件为1，确保文件夹被判定为"更小"，升序时在前；降序时也会因为文件的优先级更高，文件夹依然在前
            int thisPriority = isThisFolder ? 0 : 1;
            int otherPriority = isOtherFolder ? 0 : 1;
            return thisPriority < otherPriority;
        }

        // 类型相同时，按文本名称排序
        return text() < other.text();
    }
};

步骤2：添加Item时标记类型 #

在向表格添加文件/文件夹条目时，通过Qt::UserRole存储是否为文件夹的标记：

// 示例：假设你遍历文件系统获取条目
QString entryName = "xxx";
bool isFolder = true; // 根据实际判断逻辑设置

CustomFolderItem* item = new CustomFolderItem(entryName);
// 标记是否为文件夹
item->setData(Qt::UserRole, isFolder);
ui.table->setItem(row, 0, item);

步骤3：正常调用排序 #

现在你原来的排序代码可以正常使用，排序逻辑会自动应用自定义规则：

int columnNumber = 0; // 第一列
ui.table->sortItems(columnNumber, Qt::AscendingOrder);
// 即使是降序，文件夹依然会排在文件前面，同类型按名称降序
// ui.table->sortItems(columnNumber, Qt::DescendingOrder);

方法二：使用QSortFilterProxyModel（更灵活） #

如果你的表格数据来自自定义模型，或者需要更灵活的排序过滤逻辑，推荐使用代理模型的方式，不需要修改Item类。

步骤1：创建自定义代理模型 #

继承QSortFilterProxyModel，重写lessThan方法实现优先级排序：

#include <QSortFilterProxyModel>

class FolderFirstProxy : public QSortFilterProxyModel {
protected:
    bool lessThan(const QModelIndex& left, const QModelIndex& right) const override {
        // 只对第一列应用自定义排序
        if (left.column() == 0 && right.column() == 0) {
            // 从源模型获取是否为文件夹的标记
            bool leftIsFolder = sourceModel()->data(left, Qt::UserRole).toBool();
            bool rightIsFolder = sourceModel()->data(right, Qt::UserRole).toBool();

            if (leftIsFolder != rightIsFolder) {
                // 文件夹优先，所以左侧是文件夹时，判定为"更小"，排在前面
                return leftIsFolder;
            }
        }
        // 其他列或同类型条目，使用默认排序逻辑
        return QSortFilterProxyModel::lessThan(left, right);
    }
};

步骤2：给表格设置代理模型 #

在初始化表格时，替换默认模型为自定义代理：

// 创建代理模型
FolderFirstProxy* proxyModel = new FolderFirstProxy(this);
// 设置源模型为表格的原始模型
proxyModel->setSourceModel(ui.table->model());
// 给表格设置代理模型
ui.table->setModel(proxyModel);

步骤3：添加数据时标记类型 #

和方法一一样，添加条目时需要通过Qt::UserRole标记是否为文件夹：

QTableWidgetItem* item = new QTableWidgetItem(entryName);
item->setData(Qt::UserRole, isFolder);
ui.table->setItem(row, 0, item);

步骤4：调用排序 #

同样可以正常使用原来的排序代码，代理模型会自动处理优先级：

ui.table->sortItems(0, Qt::AscendingOrder);

关键注意事项 #

• 必须确保每个条目都正确设置了Qt::UserRole的布尔值，否则排序逻辑会失效；
• 如果需要对其他列也应用特殊排序，可以在自定义逻辑中扩展列的判断；
• 两种方法都能实现文件夹始终在文件上方的效果，方法一更轻量，方法二更适合复杂的模型场景。

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