QTableView展示百万行数据如何实现滚动到底分批加载

QTableView本身已经做了可视区域渲染优化，百万行场景下的性能瓶颈基本都出在模型层全量加载数据、不规范的模型刷新操作上，按需加载的核心是轻量自定义模型+滚动触底增量追加+非UI线程加载数据，整套实现不需要重写视图的绘制逻辑，稳定性和性能都有保障。

1. 自定义模型层（核心部分） #

不要直接用QStandardItemModel存百万行数据，它为每个单元格生成Item对象的内存开销极高，百万行轻轻松松占掉数G内存。直接继承QAbstractTableModel实现自定义模型，内部用轻量连续容器（比如QVector<自定义数据结构体>）存储已加载的数据块：

• 初始状态下容器里只存第一批1000行数据，rowCount()接口直接返回当前容器的实际数据量，不要一开始就返回一百万的总数。
• 常规接口columnCount()、data()、flags()保持轻量，data()里只做索引合法性校验，直接返回对应位置的数据，不要塞多余的计算逻辑。
• 单独写增量追加数据的接口，严格遵循Qt模型的更新规范，绝对不要全量reset模型：

  void CustomTableModel::appendRows(const QVector<DataItem>& newRows)
  {
      if (newRows.isEmpty()) return;
      int insertStart = m_datas.size();
      int insertEnd = insertStart + newRows.size() - 1;
      beginInsertRows(QModelIndex(), insertStart, insertEnd);
      m_datas.append(newRows);
      endInsertRows();
  }
  

  用beginInsertRows/endInsertRows包裹追加操作，视图只会重绘新增的行区域，不会触发全表重绘，卡顿感基本为0。

2. 滚动触底检测逻辑 #

不要重写QTableView的鼠标事件、绘制事件做检测，直接绑定垂直滚动条的信号就行，开销最低也最稳定：

• 获取QTableView的垂直滚动条，连接它的valueChanged(int)信号到自定义的检查槽函数。
• 槽函数里加加载锁，避免滚动过程中重复触发加载请求：

  void Widget::onVerticalScroll(int value)
  {
      QScrollBar* vBar = tableView->verticalScrollBar();
      // 判断是否滑到最底部：当前滚动位置 + 可视区域高度 >= 滚动条总高度
      if (value + vBar->pageStep() >= vBar->maximum() && !m_isLoading)
      {
          m_isLoading = true;
          // 触发下一批数据加载，每次步长保持和初始加载一致，比如1000行
          loadNextBatch(1000);
      }
  }
  

• 如果需要做顶部反向加载（比如初始加载中间段数据，向上滑加载更早的内容），逻辑完全一致，只是判断滚动条到0的时候往容器头部插数据就行，同样用beginInsertRows接口。

3. 数据加载的避坑点 #

• 所有IO类操作（数据库查询、文件读取、网络请求）全部放到子线程执行，绝对不要在UI线程跑加载逻辑，不然加载过程中界面会直接卡死。可以用QtConcurrent::run把加载任务扔到线程池，加载完成后通过队列信号把数据传回UI线程，调用模型的appendRows接口追加，追加完成后把m_isLoading标记重置为false。
• 体验优化：触发加载的时候可以在表的最后一行临时插入一个“加载中...”的占位行，数据加载完成后删掉占位行再插入真实数据，用户感知会更流畅。
• 如果需要让滚动条位置匹配百万行的总长度，可以一开始就把垂直滚动条的最大值设为1000000，监听滚动位置计算当前应该加载哪一段的数据，用户完全感知不到按需加载的逻辑，比单纯触底加载的体验更好。

4. 必开的性能优化配置 #

给QTableView开这几个属性，渲染性能至少提升30%：

// 固定行高，开了之后视图不需要逐行计算行高，性能提升最明显
tableView->setUniformRowHeights(true);
// 不需要编辑就直接关掉编辑触发，减少不必要的事件响应
tableView->setEditTriggers(QAbstractItemView::NoEditTriggers);
// 按行选择，不需要多选就开单选模式，减少选中状态重绘开销
tableView->setSelectionBehavior(QAbstractItemView::SelectRows);
tableView->setSelectionMode(QAbstractItemView::SingleSelection);
// 关掉不必要的网格线冗余渲染
tableView->setShowGrid(false);

另外自定义委托的paint方法里不要动态创建对象、不要做复杂计算，尽量复用已有资源。

常见坑提醒：很多旧教程会推荐用模型自带的canFetchMore/fetchMore接口实现增量加载，这个接口的触发时机由视图内部的渲染逻辑控制，快速滚动的时候很容易出现触发不及时白屏、重复加载的问题，自己控制滚动条触底逻辑的稳定性要高很多。

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