陈易铭写 Qt 界面的朋友，十个里有八个刚接触表格时都绕不开 QTableWidget。数据列表、配置管理、日志查询、报表预览，随便一个工具软件都能用到表格。很多人一开始用 QTableWidget，几百行数据没问题，但数据一旦上万，滚动卡顿、界面假死就全来了。标题里说的“优化篇”，重点就是解决这些真实开发里会踩的坑。
这篇文章我不会从“什么是 Qt 表格”这种幼儿园级别开始讲，默认你至少已经会创建一个 QTableWidget 然后往里面塞几行文字。我要讲的是从“能跑”到“好用”的这段路：控件选型、Model/View 的核心原理、大数据量下的性能优化、交互体验调整、样式美化，还有发布之后程序起不来的那些经典问题。适合刚入坑 Qt、想把手头表格做得更流畅的人看，也适合被老板一句“表格数据多了就卡”逼到想重构的人拿来抄作业。
1. 为什么要从“能跑”优化到“好用”
很多人觉得表格能显示数据不就完了吗？真不是。表格和数据量强相关，数据一多，性能问题和交互问题会同时爆发。一个只有几百行的表，你怎么写都能跑；但到了几万行、几十万行，代码写得好不好，体验差距会变得特别明显。
1.1 表格控件的选型：QTableWidget 还是 QTableView
初学者最常见的误区是只会用 QTableWidget。QTableWidget 的好处是拿起来就用，setItem 塞 QTableWidgetItem 就行，不用理解模型和视图的关系。但它的代价也很直接：每个单元格都是一个 QTableWidgetItem 对象，数据量大了以后光创建这些对象就是一笔巨大的内存开销。我实测过，往 QTableWidget 里塞十万行、每行十列的数据，光构造 QTableWidgetItem 就能让界面卡好几秒，更别说滚动时还要处理绘制。
QTableView 走的是 Model/View 架构，单元格的数据不是预先塞进控件里的，而是视图需要显示某个区域时，主动到模型里去取。这就带来了两个关键优势：第一，数据可以存在自己的结构里，比如 QVector、QList、甚至数据库查询结果，不用复制一份到 Item 对象；第二，视图只绘制当前可见区域，滚动的时候不会把所有行都重新画一遍。
所以我的建议很直接：新写的项目，表格一律用 QTableView + QAbstractTableModel。QTableWidget 只适合数据量极小、只是为了演示一次性界面的场景。你要是已经在用 QTableWidget 而且数据量已经爆炸，也不用慌，后面我会讲怎么平滑迁移到 QTableView。
1.2 性能瓶颈到底在哪里
表格卡顿的本质，是界面线程被大量工作占住了。具体拆开看，瓶颈一般出现在三个地方：
构建数据慢。比如在一个循环里 setItem 插入几千上万个单元格，每个单元格都要 new 一个 QTableWidgetItem，这个分配内存的过程非常浪费时间。
重绘范围过大。有些代码喜欢在数据更新后调用 model->reset() 或 ui->table->clearContents()。这两个操作都会让整个视图失效，所有可见和不可见的行都可能被重新计算、重新绘制。正确做法是只通知模型某几行某几列发生了变化，用 dataChanged 信号做局部刷新。
布局计算频繁。表格的行高和列宽如果没设置 uniformRowHeights，每一行的行高可能需要单独计算。数据多的时候，每次滚动到新区域都要重新计算高度，这个开销会成倍放大。
1.3 优化的整体思路：备菜、传菜、上菜
表格优化跟做饭备菜很像。菜越多，切菜这种脏活累活就别在客人面前做，尽量提前备好；上菜的时候只端客人需要的几盘，不要一次把所有菜全端到桌子上。
对应到代码上就是三句话：数据尽量在后台线程准备好，界面线程只负责把准备好的数据交给模型；模型只给视图提供可见区域需要的数据，不要一次性把所有数据都变成单元格对象；数据变化时只刷新受影响的行列，不要动辄全表重置。
这三条看着简单，但绝大多数性能问题都能被这三条覆盖。后面第二、第三部分我会分别展开讲代码怎么写。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心细节解析：Model/View 必须吃透
Model/View 这套东西，入门时总觉得绕，但一旦理解了就发现特别清晰。核心就一句话：视图是“问”数据的，不是“存”数据的。
2.1 QAbstractTableModel 骨架代码
我一般会写一个非常简单的自定义模型类，把数据存在 QVector 里面。下面这个骨架是我项目里最常用的结构，去掉业务逻辑后最小能跑起来。
cpp复制class MyTableModel : public QAbstractTableModel
{
Q_OBJECT
public:
struct RowData {
QString name;
int count = 0;
double price = 0.0;
};
explicit MyTableModel(QObject *parent = nullptr)
: QAbstractTableModel(parent) {}
int rowCount(const QModelIndex &parent = QModelIndex()) const override
{
return parent.isValid() ? 0 : m_rows.size();
}
int columnCount(const QModelIndex &parent = QModelIndex()) const override
{
return parent.isValid() ? 0 : 3;
}
QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override
{
if (!index.isValid() || index.row() < 0 || index.row() >= m_rows.size())
return QVariant();
const RowData &row = m_rows.at(index.row());
switch (index.column()) {
ca