QTableView未完整显示SQLite数据及过滤结果异常问题求助

嘿，我碰到过好几个开发者朋友用QSqlQueryModel搭配QSortFilterProxyModel时，都遇到过你说的这种情况——8k多行数据初次加载没显示全，输入过滤文本也得不到预期结果，咱们一步步来排查解决：

一、初次加载数据不全的常见原因及解决办法 #

1. QSqlQueryModel默认是延迟加载数据 #

QSqlQueryModel默认采用延迟加载（fetch more）机制，它不会一次性把所有数据都拉到内存里，而是等你滚动到表格底部时才会去取新的数据。如果你的QTableView没触发自动加载，看起来就像是数据没显示全。

最直接的解决办法就是手动触发一次性加载所有数据，初始化模型后加个循环就行：

QSqlQueryModel *model = new QSqlQueryModel(this);
model->setQuery("SELECT * FROM your_table_name");
// 循环加载直到没有更多数据
while (model->canFetchMore()) {
    model->fetchMore();
}

8k行数据完全不用担心内存问题，这个操作很安全。

2. 先确认查询结果本身是否完整 #

有时候可能是SQL语句写错、数据库连接出问题，导致查询返回的结果本身就不全。你可以先打印一下模型的总行数，看看是不是真的拿到了8611行：

qDebug() << "模型返回总行数：" << model->rowCount();

如果这个数字比8611小，那得先排查数据库连接和SQL语句——比如有没有正确打开数据库，表名、字段名是不是写错了，直接用SQLite可视化工具（比如DB Browser for SQLite）跑一遍你的查询语句，看看返回结果对不对。

二、过滤结果不符合预期的问题 #

用setFilterFixedString()没得到想要的结果，通常是这几个细节没处理好：

1. 过滤的列没设置对 #

QSortFilterProxyModel默认只对第0列（也就是表格第一列）进行过滤，如果你的过滤文本是针对其他列的，那肯定会漏掉结果。一定要记得设置过滤的目标列：

QSortFilterProxyModel *proxy = new QSortFilterProxyModel(this);
proxy->setSourceModel(model);
// 比如要过滤第2列，索引从0开始，这里写1
proxy->setFilterKeyColumn(1);

如果需要同时过滤多列，setFilterFixedString()就不够用了，得重写filterAcceptsRow()函数实现自定义过滤逻辑，后面我会给你示例。

2. 大小写敏感的坑 #

setFilterFixedString()是严格区分大小写的，如果数据库里的数据是混合大小写，而你输入的过滤文本大小写不匹配，就会漏掉结果。如果想要忽略大小写，推荐用正则表达式过滤：

// 忽略大小写的过滤方式
connect(ui->lineEdit, &QLineEdit::textChanged, this, [=](const QString &text){
    proxy->setFilterRegExp(QRegExp(text, Qt::CaseInsensitive));
});

这样不管输入的是大写还是小写，都能匹配到对应的数据。

3. 代理模型的映射和信号槽检查 #

首先要确认你已经把代理模型正确设置给了QTableView：

ui->tableView->setModel(proxy);

然后检查QLineEdit的textChanged信号有没有正确连接到过滤逻辑——比如是不是漏写了connect，或者lambda表达式里的变量有没有捕获正确。

三、多列过滤的实现示例 #

如果需要同时过滤多个列，比如第0列和第1列，你可以自定义一个代理模型：

class MultiColumnFilterProxy : public QSortFilterProxyModel {
protected:
    bool filterAcceptsRow(int source_row, const QModelIndex &source_parent) const override {
        // 获取当前行第0列和第1列的数据
        QModelIndex col0Index = sourceModel()->index(source_row, 0, source_parent);
        QModelIndex col1Index = sourceModel()->index(source_row, 1, source_parent);
        QString col0Text = sourceModel()->data(col0Index).toString();
        QString col1Text = sourceModel()->data(col1Index).toString();
        
        // 只要任意一列包含过滤文本就显示
        return col0Text.contains(filterRegExp()) || col1Text.contains(filterRegExp());
    }
};

然后用这个自定义代理代替默认的QSortFilterProxyModel就行，记得设置正则表达式过滤（支持大小写不敏感）。

内容的提问来源于stack exchange，提问作者pr.nizar