Llenlleawg做桌面客户端项目的人，迟早会遇到 QTableWidget。它不像 QTableView 那样自带 MVC 光环，但就是简单直接，很多工具型、后台管理型软件里依然大量用它。我维护过一个工单录入系统，表格只有不到十列，却要边接收实时消息边刷新上千行数据，滚动、选中、编辑各种操作叠在一起，不优化真的会卡。这篇文章不是从“怎么建表”开始讲，而是以项目实战为前提，说说我在 QTableWidget 上实际用过的行为、坑和取舍，重点放在“数据量大怎么加载才不卡”这个方向上。如果你写 Qt 时也被表格刷新手感困扰过，这篇应该能帮你省不少排查时间。
1. 为什么QTableWidget这种“老面孔”在项目里依然躲不掉
1.1 QTableWidget和QTableView的本质差别
很多初学者搞不清 QTableWidget 和 QTableView 的区别，其实从使用体验上看，差别非常直接：QTableWidget 自带一个藏在内部的数据模型，你不需要自己实现 rowCount()、data()、setData() 这些方法，直接用 setItem() 往单元格里塞 QTableWidgetItem 就行。QTableView 则只是“壳”，数据要由外部数据模型提供，最典型的是继承 QAbstractTableModel 再交给 View 显示。
从内存和更新机制上说，QTableWidget 是一个“数据与 View 耦合得更紧”的组件。它默认会为你管理每个单元格里的 QTableWidgetItem，你在界面上看到多少，内存里基本就有多少个对象。而 QTableView 适合真正大型数据系统，因为模型可以只在视图请求某一行某一列时才准备数据，甚至可以做异步拉取。
那为什么项目里最终还是选了 QTableWidget？大多是因为：业务数据量没有大到必须上 Model/View，但又要求开发速度快、改动直接。比如部门内部管理工具、配置检查器、日志查看器，有个几千行数据已经算多的了。这种情况下用 QTableWidget 能省掉大量模型样板代码，维护成本也更低。如果一上来就设计 QAbstractTableModel，反而容易把简单需求绕复杂。
1.2 先给自己的数据量算一笔账
我一般建议先算一笔账：如果行数长期在 5000 行以内，列数不超过 20 列，并且不需要多视图联动、不同控件共享同一份数据，QTableWidget 完全可以快速交付。等行数摸到几万、几十万，甚至需要频繁增删改，再考虑切换成 QTableView。
为什么是 5000 这个量级？因为单个 QTableWidgetItem 不是简单的一个字符串，它内部要维护 display、tooltip、background、font、text alignment 等角色数据，还要参与 Qt 的模型索引和视图元数据处理。创建一个 item、再调用 setItem() 的损耗，比普通人想象得大。我记得之前做过一个测试：构造 10 万行、每行 10 列的 item，光 new QTableWidgetItem 加 setItem() 就可能消耗几百毫秒到几秒，具体和机器配置、编译器优化、Debug/Release 模式都有关系。
还有一点容易被忽略：QTableWidget 在某些版本中如果开启了排序，而你在循环里一个单元格一个单元格地塞数据，那么每次 setItem() 都可能导致内部排序逻辑被触发，这是性能雪上加霜的核心原因之一。想继续用 QTableWidget，就得先把这些问题提前处理掉。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 填充表格数据前，我建议想清楚的几个低配置性能习惯
2.1 先关排序，再填数据
这条我放在最前面，因为很多人遇到“QTableWidget 数据多时加载特别慢”，第一个想到的是换组件，却忽略了排序开关。只要表格设置了：
cpp复制ui->tableWidget->setSortingEnabled(true);
那么你每往里塞一条数据，Qt 都会尝试调整行顺序。如果是升序或降序排列，它会频繁比较并移动 item。十万行数据边插入边排序，时间会成倍增长。
正确的填数据姿势是：先把排序关掉，数据全部填充完成后再打开排序，并且调用一次 sortByColumn() 触发最终排一次：
cpp复制ui->tableWidget->setSortingEnabled(false);
// 循环填充数据...
ui->tableWidget->setSortingEnabled(true);
ui->tableWidget->sortByColumn(0, Qt::AscendingOrder);
这个小改动对加载速度影响非常直接。如果你的业务逻辑要求在数据插入过程中始终保持可视排序，那说明 QTableWidget 已经不适合了，那是另一种问题，放在后面讨论。
2.2 先分配行结构，再填充单元格
QTableWidget 默认没有固定行数，很多人图省事，在循环里每来一条数据就调用一次 insertRow() 或者 setRowCount()，这样会导致行结构反复重新分配。
对于已知数据量的批量加载，先用一次 setRowCount() 把行数分配好，再按行号填充。当然，如果 setRowCount() 的行数比最终实际需要的行数多，后续记得用 setRowCount(实际数量) 收缩掉，否则会在底部留很多空白行。
这里有一个细节：setRowCount() 只是分配内部行结构，它不会为每个单元格创建 QTableWidgetItem。也就是说，就算你设置 setRowCount(100000)，只要没调用 setItem，内存压力也并不会很大。很多表格慢的根源不是“行数多”，而是“每个单元格都被 new 了对象”。这一点在下一章会详细展开。
2.3 频繁刷新时优先复用现有QTableWidgetItem
实时刷新场景下，常见写法是清空表格再重新 setItem。