做Qt界面开发，绕不开“表格展示”这个需求。我接过的项目里，十个有八个最终都要在界面上摆一个能看、能点、能编辑的表格控件，而大多数人第一时间想到的都是QTableView。但真正把这套模型/视图机制玩明白的人其实不多——大多数人只是把它当成一个更好用的QTableWidget在用，结果数据一多就卡，想加个下拉框编辑还得绕路，换个数据源恨不得重写整个界面。
这篇内容就是围绕QTableView的完整用法展开的。我会从最基础的模型/视图架构讲起，带你手写一个能跑、能编辑、能排序的表格，再深入自定义模型和委托，最后把我在实际项目里踩过的那些坑挨个说一遍。不管你是刚接触Qt的新手，还是已经写过几个界面但总觉得表格用得不顺手的开发者，这篇内容都能给你一些可以直接抄作业的参考。
1. 整体设计思路：为什么Qt要把表格拆成“模型”和“视图”
1.1 模型/视图架构到底解决了什么问题
先聊一个很多人没想明白的问题：为什么Qt不直接把表格数据塞进控件里，非要拆出一个“模型”（Model）和“视图”（View）的架构？
我用一个生活化的类比来解释。你把QTableView想象成一家餐厅的用餐区，食客看到的是桌布、餐具、服务员的热情招呼，这是“视图”。而后厨里的菜单、食材库存、菜品配方，这是“模型”。服务员（视图）不会自己到后厨炒菜，他需要什么菜，就通过一个标准流程告诉后厨（模型），后厨把菜做好了再端出来。
对应到代码里，QTableView只管“展示成什么样”——行高列宽、字体颜色、是否可编辑、选中是什么样式，这些都是视图层的责任。而“数据从哪来、有多少行多少列、某个单元格里是什么值、能不能改”，这些是模型层的责任。二者通过一套标准接口通信，也就是QAbstractItemModel定义的那一堆虚函数。
这样设计最大的好处是：数据源可以任意替换。同样是这张表，你今天用内存里的QStandardItemModel，明天换成从数据库读数据，后天改成从网络接口动态拉取，只要自定义一个模型类，把接口实现好，视图层一行代码都不用改。我在一个实际项目中就因为这个架构省了大功夫——界面先用假数据调通，后来后端接口好了，写了一个继承QAbstractTableModel的模型类填进去，界面完全没动。
1.2 QTableView和QTableWidget，很多人在第一步就选错了
新手最常犯的错误，就是分不清QTableView和QTableWidget。这两兄弟名字长得像，功能也像，但定位完全不同。
QTableWidget是QTableView的“便捷子类”，它内置了一个默认的模型，把每个单元格直接封装成了QTableWidgetItem对象。你不需要理解模型/视图的架构，代码写起来非常直白：
QTableWidget *table = new QTableWidget(this); table->setRowCount(5); table->setColumnCount(3); table->setItem(0, 0, new QTableWidgetItem("张三")); table->setItem(0, 1, new QTableWidgetItem("85"));这玩意儿用起来是真爽，但它的代价是：你被绑死在了QTableWidgetItem这个数据结构上。想从数据库读数据？行，你得先把数据库结果一行行拆成QTableWidgetItem再塞进去。数据量大一点（比如几千行）就开始卡顿，因为每次setItem都会触发一次界面刷新。
而QTableView本身是一个“空壳”，它不自带数据。你必须给它一个模型，数据完全由模型来管。前期多写几个类，后期处处舒服。
我的建议是：项目里需要展示的数据如果是固定写死的、量很小的（比如一个设置对话框里的简单列表），直接用QTableWidget省事；但凡数据是动态的、来自外部数据源的、或者单元格需要定制编辑控件的，从第一天就用QTableView加自定义模型。我当时在做一个跨平台的数据分析工具时，一开始图省事用了QTableWidget展示原始数据，后来要加多级表头、数据库分页加载、单元格进度条，发现QTableWidget怎么都绕不过去，最后咬牙重写成QTableView。如果一开始就走模型/视图的路子，能节省至少一周的返工时间。
2. 快速上手：用QTableView显示第一张表格
2.1 准备工作与环境搭建
这篇文章的代码基于Qt 5.15或Qt 6.x版本，理论上两者都能跑通。我用的构建方式是Qt自带的qmake或CMake都行，核心代码不需要额外引入第三方库，只用Qt Widgets模块。
在.pro文件中确保包含：
QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets如果你的项目是用CMake管理的，在CMakeLists.txt里加上：
find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(your_target PRIVATE Qt6::Widgets)然后包含必要的头文件：
#include <QApplication> #include <QTableView> #include <QStandardItemModel> #include <QHeaderView>2.2 用QStandardItemModel快速填充数据
QStandardItemModel是Qt提供的最简单的通用模型，适合快速验证想法。它和QTreeWidget类似，每个单元格都是一个QStandardItem对象，可以设置文本、图标、对齐方式、背景色等。
我写一个最简单的示例：做一个学生成绩表，包含姓名、语文、数学、英语四列，以及三行学生数据。
QStandardItemModel *model = new QStandardItemModel(this); // 设置表头 model->setHorizontalHeaderLabels({"姓名", "语文", "数学", "英语"}); // 填充数据 QList<QStandardItem*> row1; row1 << new QStandardItem("张三") << new QStandardItem("88") << new QStandardItem("92") << new QStandardItem("85"); model->appendRow(row1); QList<QStandardItem*> row2; row2 << new QStandardItem("李四") << new QStandardItem("76") << new QStandardItem("81") << new QStandardItem("79"); model->appendRow(row2); QList<QStandardItem*> row3; row3 << new QStandardItem("王五") << new QStandardItem("95") << new QStandardItem("67") << new QStandardItem("90"); model->appendRow(row3); QTableView *view = new QTableView(this); view->setModel(model);把view通过布局管理器添加到主窗口后，运行程序就能看到一张完整表格了。这里有几点细节需要说明：
appendRow传入的是一个QList<QStandardItem*>，列表里每一列对应一个item。顺序很重要，第一个对应第0列，第二个对应第1列，依此类推。- 如果你用
setItem(row, col, item)的方式填充，就不需要按照列顺序来，适合动态修改某个特定单元格。 - 表头标签用
setHorizontalHeaderLabels设置，传入一个QStringList。如果你的表头内容不多，直接初始化列表字面量更简洁。
2.3 显示细节调优：列宽、行高、排序、选择模式
表格能做出来和好用之间，差着一堆小细节。以下这些配置是我每次创建QTableView后几乎必调的项，顺序也基本固定。
列宽自适应内容
view->resizeColumnsToContents(); view->horizontalHeader()->setStretchLastSection(true);第一行让所有列宽自动匹配内容宽度，第二行让最后一列自动拉伸填满剩余空间。如果你希望所有列均匀拉伸，可以把setStretchLastSection换成：
view->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);这个模式会平均分配空间，适合列数少、列宽要求均匀的场景。但要注意，Stretch模式下用户手动调整列宽是无效的，如果想保留用户拖动列宽的能力，用Interactive模式（默认就是）配合至少一列Stretch是最好的折中方案。
行高控制
view->verticalHeader()->setDefaultSectionSize(30); view->verticalHeader()->setVisible(false); // 隐藏行号，更简洁表格数据比较密集时，把行号列隐藏掉能让界面清爽很多。默认行高根据字体大小自动计算，如果你觉得默认行高太挤，手动设为30像素左右比较合适。
排序功能
QStandardItemModel本身不排序，需要给表格加一个代理模型QSortFilterProxyModel来实现。这句代码非常简单：
QSortFilterProxyModel *proxy = new QSortFilterProxyModel(this); proxy->setSourceModel(model); // 把原始model塞进代理 view->setModel(proxy); // 视图挂在代理上加了代理之后，点击表头就会自动排序。代理的意义在于：原始模型的数据顺序不变，排序只发生在代理层，这样你可以在界面上显示一个顺序，同时内部逻辑保持原来的数据顺序。我后来在做数据透视表类似的界面时，就是靠这个机制在同一个QTableView上切换多种排序方式，原始数据完全不动。
还有一个细节：QStandardItemModel存储的数值是字符串形式，排序时默认按字符串首字符排，会出现“10”排在“2”前面的问题。解决办法是对QStandardItem设置数字类型：
QStandardItem *item = new QStandardItem; item->setData(92, Qt::DisplayRole); // 用int类型存 // 这样排序就会按数值大小进行或者更通用一点，在模型里重写处理，后面讲自定义模型时再展开。
选择模式与行为
view->setSelectionBehavior(QAbstractItemView::SelectRows); // 选中一整行 view->setSelectionMode(QAbstractItemView::SingleSelection); // 只允许单选这两个配置非常实用。默认情况下点击单元格只选中一个格子，对业务逻辑来说用户体验很差——做表格展示时用户通常希望选一整行。SelectRows配合SingleSelection，用户点哪一行就高亮整行，而且只有一个焦点，逻辑清楚。如果你需要多选（比如批量导出），把SingleSelection改成ExtendedSelection，按住Ctrl或Shift可以多选行。
隔行变色
view->setAlternatingRowColors(true);开启后偶数行和奇数行会有不同的背景色，视觉上更容易区分数据行。配合一个干净的白灰配色（默认不需要额外写样式表），长时间盯屏幕也不会疲劳。
3. 核心进阶：自定义模型与委托的使用
3.1 自定义模型的必备接口和实现细节
QStandardItemModel解决了“能显示”的问题，但当你需要直接对接数据库、或者对数据的存取逻辑做严格控制时，就得自己写模型类了。这里最核心的要点是理解QAbstractTableModel的四个纯虚函数和两个可选函数。
class StudentTableModel : public QAbstractTableModel { Q_OBJECT public: explicit StudentTableModel(QObject *parent = nullptr); // 必须实现的四个接口 int rowCount(const QModelIndex &parent = QModelIndex()) const override; int columnCount(const QModelIndex &parent = QModelIndex()) const override; QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override; // 可选的编辑支持接口 bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override; Qt::ItemFlags flags(const QModelIndex &index) const override; private: QList<StudentInfo> m_students; // 内部数据结构 };rowCount和columnCount返回模型的总行数和总列数。这里有个重要细节：入参parent通常是无用的，只有当模型是树形结构（比如QTreeView）时才需要根据parent判断返回子行数。对于表格模型，直接返回总行数即可，不要理会parent.isValid()。
data是整个模型里最重要的函数，它决定了视图在绘制每个单元格时获取什么内容。视图会反复调用这个函数，请求不同的角色（role）。Qt::DisplayRole表示单元格显示的文字，Qt::TextAlignmentRole表示对齐方式，Qt::BackgroundRole表示背景色。
我的经验是：在data函数里用switch或者if分支把不同角色分别处理，不要只返回DisplayRole。举个实际项目中的例子：
QVariant StudentTableModel::data(const QModelIndex &index, int role) const { if (!index.isValid()) return QVariant(); const StudentInfo &stu = m_students.at(index.row()); if (role == Qt::DisplayRole) { switch (index.column()) { case 0: return stu.name; case 1: return stu.chineseScore; case 2: return stu.mathScore; case 3: return stu.englishScore; default: return QVariant(); } } else if (role == Qt::TextAlignmentRole) { // 成绩居中显示 return QVariant(Qt::AlignCenter); } else if (role == Qt::BackgroundRole) { // 成绩低于60分的标红 if (index.column() >= 1 && index.column() <= 3) { int score = stu.scoreAt(index.column()); if (score < 60) return QBrush(QColor(255, 220, 220)); } return QVariant(); } return QVariant(); }这里涉及一个新手容易踩的坑：视图会为每个可见的单元格请求多种角色，比如文字颜色、字体、对齐方式等。如果你只处理了DisplayRole，其它角色返回QVariant()（空值）也是可以的，视图会采用默认样式。但如果你设置了某个角色，就必须完整返回正确的类型。比如TextAlignmentRole需要返回Qt::Alignment枚举，用QVariant(Qt::AlignCenter)包裹。
headerData用于返回表头和行头文本。每个section对应一列（横向）或一行（纵向）。横向时orientation是Qt::Horizontal，section就是列号，返回那一列的表头名称；纵向时orientation是Qt::Vertical，section就是行号，默认返回行号数字，也可以返回自定义内容。
3.2 支持编辑：setData与flags
默认情况下QAbstractTableModel的所有单元格都是不可编辑的。要让表格支持双击编辑，需要两个函数配合。
首先，flags函数要返回包含Qt::ItemIsEditable的标记：
Qt::ItemFlags StudentTableModel::flags(const QModelIndex &index) const { if (!index.isValid()) return Qt::NoItemFlags; Qt::ItemFlags f = Qt::ItemIsEnabled | Qt::ItemIsSelectable; if (index.column() >= 1 && index.column() <= 3) { f |= Qt::ItemIsEditable; } return f; }这个写法很关键：只有成绩列允许编辑，姓名列不允许。实际项目中经常需要对不同列开放不同的操作权限。
然后，setData函数要有实际写入逻辑：
bool StudentTableModel::setData(const QModelIndex &index, const QVariant &value, int role) { if (!index.isValid() || role != Qt::EditRole) return false; StudentInfo &stu = m_students[index.row()]; switch (index.column()) { case 1: stu.chineseScore = value.toInt(); break; case 2: stu.mathScore = value.toInt(); break; case 3: stu.englishScore = value.toInt(); break; default: return false; } // 通知视图数据已变化，需要刷新 emit dataChanged(index, index, {Qt::DisplayRole, Qt::EditRole}); return true; }这里最容易被遗漏的一行是emit dataChanged(...)。很多新手写完setData后，发现双击编辑输入新值，界面纹丝不动——原因就是忘了通知视图数据更新了。dataChanged信号的参数是左上角和右下角两个索引，表示数据变化的范围，后面还可以传一个角色列表，告诉视图哪些角色需要重查。
3.3 委托（Delegate）：让单元格随你掌控
QTableView默认的编辑控件是一个QLineEdit。如果某个列想用下拉框选值、或者用一个进度条展示数据进度，就需要委托（QStyledItemDelegate）出场。
委托解决的核心问题是：视图不知道怎么让用户编辑特定类型的数据，也不知道除了文本以外还能怎么绘制单元格。模型负责存数据，视图负责基础绘制，而委托负责“这个单元格长什么样、点进去怎么编辑”。
我举一个实战场景：在成绩表旁边加一列“评价等级”，用户通过下拉框选择“优/良/及格/不及格”。自定义委托的代码结构如下：
class GradeDelegate : public QStyledItemDelegate { Q_OBJECT public: using QStyledItemDelegate::QStyledItemDelegate; // 创建编辑控件（双击/按F2时调用） QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override { QComboBox *combo = new QComboBox(parent); combo->addItems({"优", "良", "及格", "不及格"}); return combo; } // 把模型里的值设置到编辑控件中 void setEditorData(QWidget *editor, const QModelIndex &index) const override { QComboBox *combo = qobject_cast<QComboBox*>(editor); QString value = index.data(Qt::DisplayRole).toString(); combo->setCurrentText(value); } // 把编辑控件中的值写回模型 void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const override { QComboBox *combo = qobject_cast<QComboBox*>(editor); model->setData(index, combo->currentText(), Qt::EditRole); } // 更新编辑控件的几何大小，保证它出现在正确位置 void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const override { editor->setGeometry(option.rect); } };然后把这个委托设置到对应的列上：
view->setItemDelegateForColumn(4, new GradeDelegate(view));new GradeDelegate(view)设了父对象，所以不用担心内存泄漏——Qt的父子对象机制会在view销毁时自动清理委托。
同理，如果你想用进度条显示成绩，只需要在paint函数里画一个QStyleOptionProgressBar。这个灵活度是QTableWidget完全没法比的。
4. 常见问题与排查技巧实战
4.1 数据更新后界面不刷新的三个原因
这个现象在论坛里出现的频率极高：“我改了模型里的数据，QTableView没动静。”原因无非以下三种。
最典型的就是前面讲的setData里忘加dataChanged信号。记住，模型改了数据，必须主动广播。无论是dataChanged还是layoutChanged，不通知视图，视图就认为数据没变，也就不会重绘。
第二种情况是修改了模型的结构——比如添加行、删除行、插入列。这种结构性变化必须调用：
beginInsertRows(QModelIndex(), row, row); // ... 实际插入数据 ... endInsertRows();或者重置整个模型：
beginResetModel(); // ... 清空数据重新填充 ... endResetModel();第三种情况是检查和确认你操作的模型实例是同一个。这个坑尤其容易出现在用了QSortFilterProxyModel之后——视图挂在代理模型上，而你调用setData的是源模型。两者之间隔着代理层，信号需要经过代理转发，如果你在setData后立即访问界面的index，拿到的仍然可能是旧数据，要等事件循环迭代一轮后才会同步。
4.2 表头显示与样式定制的问题
有用户反映“设置了表头文字，运行后不显示”。排查思路是这样的：
- 确认你设置表头是在
setModel之后，还是在之前。建议在setModel之后调用setHorizontalHeaderLabels，覆盖掉模型自带默认表头。 - 确认表头没有被
setVisible(false)隐藏。 - 检查
horizontalHeader()->setSectionResizeMode的设置，如果你把某个列的模式设为Fixed，而内容宽度比默认列宽大，文字会被截断，看起来像没显示。
表头样式定制（背景色、字体、高度）可以直接通过QSS搞定：
view->horizontalHeader()->setStyleSheet( "QHeaderView::section { background-color: #f0f0f0; " "border: 1px solid #d0d0d0; padding: 4px; font-weight: bold; }");4.3 大数据量下的性能优化方案
QTableView配合自定义模型，本身就有虚拟化的优势——只绘制可见区域。但如果你发现滚动时还是卡顿，排查方向有三个。
第一，data函数里别做耗时操作。视图在滚动时会高频调用data，如果你在里面查数据库、打开文件、做复杂的字符串转换，卡顿几乎必然。正确做法是：在模型内部先把数据预处理成纯内存的结构，data里只做取字段和返回包装。
第二，setData或批量更新数据时，能用dataChanged一次广播一个区域，就不要逐格dataChanged。比如你一次性更新了50行数据，正确的写法是：
emit dataChanged(index(0, 0), index(49, columnCount() - 1), {Qt::DisplayRole});而不是在循环里每行emit一次。后者会触发50次重绘，界面会明显闪烁。
第三，如果你需要展示几十万行级别的数据，建议配合分页加载。模型只维护当前页的数据，用户翻页时替换内部数据并调用beginResetModel/endResetModel。我自己在做一个日志分析工具时，用这个方法让界面加载100万行日志还能流畅滚动——前提是每次翻页只保留1万行在内存里。
4.4 编辑状态和焦点管理的坑
用setItemDelegateForColumn设置了QComboBox委托后，有些用户会发现下拉框选项切换了，但模型里的数据没变。排查点在setModelData函数。这个函数是视图在编辑结束后调用的，它把编辑控件里的值取出来写回模型。如果你没实现它，默认行为是调用QLineEdit的文本，对于QComboBox只会拿到空字符串。所以，只要自定义了编辑器，setModelData必须同步实现。
另外，如果你希望用户单击单元格就进入编辑状态，而不是双击，可以在表格配置：
view->setEditTriggers(QAbstractItemView::SingleClicked);默认是双击或按F2进入编辑，在需要快速批量录入的场景下，改成单击编辑能提升不少效率。不过也要看你的业务是否允许这种交互，如果表格同时承担“选中行执行操作”的职责，单击编辑和行选择会冲突，建议保留默认双击。
4.5 中文编码相关的旧坑补遗
如果你还在用Qt 5.5之前的版本或者Windows上遇到中文表头乱码，多半是编码问题。现代Qt 5和Qt 6已经全面使用UTF-16内部表示，源代码用UTF-8保存，QString直接从字面量构造，基本不会出错。但如果你在Windows上用了远古版本的编译器（比如MSVC 2010），或者从外部文件读取数据时没有正确指定编码，就可能在表格里看到乱码。解决办法是统一数据源编码为UTF-8，读取后用QString::fromUtf8转换；写入文件时用QTextStream并显式setEncoding(QStringConverter::Utf8)（Qt 6）或setCodec("UTF-8")（Qt 5）。
5. 项目实战：把表格组件灵活组合起来
说了这么多理论，我带你把前面讲的东西组合起来，做一个实用的界面。场景是这样的：某数据管理工具的主界面需要展示一批订单信息，包含订单号、客户名称、金额、状态（待处理/已处理/已取消），支持排序、筛选、编辑状态列，同时要求数据量较大时界面不卡。
5.1 构建自定义模型类
第一步，定义一个订单结构体：
struct OrderInfo { QString orderId; QString customerName; double amount; QString status; // "待处理"/"已处理"/"已取消" };第二步，自定义模型类，重写前面讲的接口。这个模型内部用QList<OrderInfo>保存数据，模型的核心逻辑就是：
rowCount返回m_orders.size()columnCount返回4data里根据index.column()返回对应字段flags里让“状态”列可编辑，其它列只读setData只处理状态列headerData返回四列表头文字
关键代码我写出来：
int OrderTableModel::rowCount(const QModelIndex &parent) const { return parent.isValid() ? 0 : m_orders.size(); } int OrderTableModel::columnCount(const QModelIndex &parent) const { return parent.isValid() ? 0 : 4; } QVariant OrderTableModel::data(const QModelIndex &index, int role) const { if (!index.isValid() || index.row() >= m_orders.size()) return QVariant(); const OrderInfo &order = m_orders[index.row()]; if (role == Qt::DisplayRole) { switch (index.column()) { case 0: return order.orderId; case 1: return order.customerName; case 2: return QString("%1").arg(order.amount, 0, 'f', 2); case 3: return order.status; default: return QVariant(); } } else if (role == Qt::TextAlignmentRole) { return (index.column() == 2) ? QVariant(Qt::AlignRight | Qt::AlignVCenter) : QVariant(Qt::AlignCenter); } return QVariant(); } bool OrderTableModel::setData(const QModelIndex &index, const QVariant &value, int role) { if (!index.isValid() || role != Qt::EditRole || index.column() != 3) return false; m_orders[index.row()].status = value.toString(); emit dataChanged(index, index, {Qt::DisplayRole, Qt::EditRole}); return true; } Qt::ItemFlags OrderTableModel::flags(const QModelIndex &index) const { if (!index.isValid()) return Qt::NoItemFlags; Qt::ItemFlags f = Qt::ItemIsEnabled | Qt::ItemIsSelectable; if (index.column() == 3) f |= Qt::ItemIsEditable; return f; }5.2 组合排序、筛选和状态委托
第二步，在界面构造函数里把这些组件组合起来：
// 创建模型并注入数据 OrderTableModel *model = new OrderTableModel(this); model->setOrders(orderList); // 创建排序筛选代理 QSortFilterProxyModel *proxy = new QSortFilterProxyModel(this); proxy->setSourceModel(model); proxy->setSortRole(Qt::DisplayRole); // 创建视图 QTableView *view = new QTableView(this); view->setModel(proxy); view->setSortingEnabled(true); // 启用表头点击排序 view->setSelectionBehavior(QAbstractItemView::SelectRows); view->setSelectionMode(QAbstractItemView::SingleSelection); view->setAlternatingRowColors(true); view->horizontalHeader()->setStretchLastSection(true); // 给状态列设置下拉框委托 view->setItemDelegateForColumn(3, new StatusDelegate(view));注意这里我把QSortFilterProxyModel放在了模型和视图中间。视图启用排序后，表头点击会自动调用代理的排序逻辑，而原始数据在模型里保持不变。
如果你还要加一个搜索框，根据客户名称过滤订单，只要在代理上调用setFilterKeyColumn(1)，然后把搜索框的textChanged信号连到一个槽函数，在槽里调proxy->setFilterFixedString(text)即可。整个表格的“显示、排序、过滤、编辑”四个能力就都齐了。
5.3 让金额列右对齐和状态列变色
数据展示的细节能看出一个界面是否用心。金额列右对齐符合财务习惯，状态列用颜色区分能让人一眼看出当前处理进度。
在data函数里加一段针对BackgroundRole或ForegroundRole的处理：
else if (role == Qt::ForegroundRole) { if (index.column() == 3) { QString status = order.status; if (status == "待处理") return QBrush(QColor(200, 80, 80)); if (status == "已处理") return QBrush(QColor(40, 130, 60)); if (status == "已取消") return QBrush(QColor(150, 150, 150)); } }这样设置之后，状态列的文字会变成红、绿、灰三种颜色，比全黑文本直观得多。ForegroundRole是文字颜色，BackgroundRole是背景色，FontRole是字体——这三个角色是自定义展示效果中最常用的三件套。
5.4 与外部数据源对接的思路
前文一直强调“模型隔离数据源”，这里用一个简单例子说明怎么对接数据库。假设你有SQLite数据库表orders，用QSqlQueryModel是最省事的方式：
QSqlQueryModel *dbModel = new QSqlQueryModel(this); dbModel->setQuery("SELECT order_id, customer_name, amount, status FROM orders"); view->setModel(dbModel);两行代码，一张数据库表就显示在QTableView上了。但QSqlQueryModel默认不能编辑，如果你需要点击状态列更新数据库，就要把它换成QSqlTableModel：
QSqlTableModel *tableModel = new QSqlTableModel(this); tableModel->setTable("orders"); tableModel->select(); view->setModel(tableModel);这个模型自带增删改查的能力，setData通过submitAll()提交到数据库，数据源从内存切换到数据库基本上是无感的。这也正是模型/视图架构最值钱的地方——你写的视图逻辑、委托逻辑、排序列配置全部可以复用，唯一变化的是中间那个模型对象。
6. 我在项目里反复踩过的坑
最后分享几个实际开发中踩过、也让别人踩过的细节问题。这些东西文档里不常见，但遇到一次就能浪费几个小时。
第一个坑是内存泄漏的隐性来源。QStandardItemModel中添加的QStandardItem，模型接管所有权后不需要手动释放——这是正确的。但如果你反复用clear()再重新appendRow，旧item会被模型释放，而你在别处保存的item指针就成了悬空指针。避免方法很简单：不要长期保存QStandardItem*的句柄，需要访问时通过model->item(row, col)获取。
第二个坑是**QTableView默认没有开启滚轮平滑滚动**。数据量大时，用鼠标滚轮快速滚动会有种“一格一格跳”的顿挫感。开启方式：
view->setVerticalScrollMode(QAbstractItemView::ScrollPerPixel);ScrollPerPixel按像素平滑滚动，ScrollPerItem按行滚动。前者视觉反馈流畅很多，尤其在触摸板上体验差异明显。
第三个坑是编辑单元格后立刻排序导致编辑内容丢失。现象是：双击编辑某个单元格，输入完按回车，内容显示了一下就“跳走”了。原因在于你启用了setSortingEnabled(true)，而当前的编辑修改被排序打断了。解决办法是在编辑开始前暂时禁用排序：
connect(view, &QTableView::doubleClicked, this, [=] { view->setSortingEnabled(false); }); connect(view, &QTableView::clicked, this, [=] { view->setSortingEnabled(true); });这个方案不算完美，但对大多数场景够用。更稳的写法是监听QAbstractItemModel::dataChanged信号，在数据变化后重新启用排序，确保新写入的数据已经落进模型再排序。
第四个坑是**setSelectionBehavior(SelectRows)后，按上下方向键移动时选中的列还在原地**。这是焦点和选择的混用问题。解决办法是把焦点策略设置为不抢焦点：
view->setFocusPolicy(Qt::NoFocus);这样方向键会直接移动行选择，而不是先移动光标到另一个单元格。对于以行为操作单位的表格界面，这个设置能让键盘操作舒服很多。
第五个坑是委托的sizeHint不生效。如果你自定义了单元格高度（比如给单元格加了一个高的图片），委托的sizeHint函数被遗漏了，行高会按照默认字体高度计算，导致内容被裁剪。实现委托时记得重写：
QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override { return QSize(100, 40); }它会直接影响视图的行高计算。视图会遍历可见区域的sizeHint来决定行高，如果你只在个别列设置了大尺寸，其它列会拉低这个值，最终行高可能取不到你期望的值。这时候可以同时用verticalHeader()->setDefaultSectionSize(40)兜底。
实际用下来，QTableView真的是Qt里最值得花时间钻研的控件之一。它把数据和展示拆开的设计，初看觉得绕，真正做几个项目之后会发现这种抽象极其合理——换数据源不换界面，加交互不改数据，逻辑边界清清楚楚。如果你现在正准备在项目里用表格组件，我的建议是从自定义模型开始写，别贪图QTableWidget的一时省事。前期多写几个函数，后期省回来的时间绝对不止一倍。
