QTableWidget中禁用setCellWidget嵌入QWidget，应改用Qt::CheckStateRole+自定义delegate实现复选框，按钮交互通过paint绘制+鼠标事件坐标命中判断实现，确保性能稳定、数据绑定正确且支持键盘操作。
QTableWidget里直接放QWidget会卡顿甚至崩溃
Qt官方明确不推荐在 QTableWidget 的单元格中用 setCellWidget() 嵌入 QCheckBox 或 QPushButton——尤其当表格行数超过百行、频繁滚动或刷新时，CPU飙升、响应迟滞、偶发crash。根本原因是 QTableWidget 是基于 item 的轻量视图，而 QWidget 是重量级对象，每单元格一个 widget 会触发大量事件分发和布局计算。
真正稳定的做法是：复选框走 Qt::CheckStateRole + 自定义 delegate；按钮走事件过滤或代理点击（不真放 button 实例）。
- ✅ 正确路径：用
QStyledItemDelegate绘制复选框视觉 + 拦截鼠标事件模拟点击 - ✅ 按钮逻辑统一收口到
QTableWidget::cellClicked(int, int)或重写mousePressEvent - ❌ 避免写
table->setCellWidget(row, col, new QCheckBox)—— 看似简单，上线后必修。
让复选框状态真正绑定数据且可编辑
复选框本质是二态（Qt::Unchecked/Qt::Checked）或三态（加 Qt::PartiallyChecked），必须通过 item 的 setData() 写入，再由 delegate 渲染。否则 UI 和数据脱节，勾选后 reload 数据就丢失。
关键点：
立即学习“C++免费学习笔记（深入）”；
- 设置 item 时必须调用
item->setFlags(item->flags() | Qt::ItemIsUserCheckable) - 显式写入初始状态：
item->setData(Qt::CheckStateRole, Qt::Unchecked) - 监听状态变化只能靠重写
QTableWidget::itemChanged(QTableWidgetItem*)，不是信号cellClicked - delegate 中的
editorEvent()必须返回true，否则点击无效
示例片段（非完整 delegate，仅核心逻辑）：
void MyDelegate::editorEvent(QEvent *event, QAbstractItemModel *model,
const QStyleOptionViewItem &option,
const QModelIndex &index) {
if (event->type() == QEvent::MouseButtonRelease) {
Qt::CheckState state = static_cast<Qt::CheckState>(
model->data(index, Qt::CheckStateRole).toInt());
model->setData(index, state == Qt::Checked ? Qt::Unchecked : Qt::Checked,
Qt::CheckStateRole);
return true; // ← 必须返回 true，否则视为未处理
}
return false;
}
按钮效果用“绘制+拦截”替代真实 widget
所谓“单元格里的按钮”，用户要的其实是「视觉上像按钮 + 点击有回调」。没必要、也不该塞一个 QPushButton 实例进去。更高效的方式是：
- 在 delegate 的
paint()里用QStyle::drawControl(QStyle::CE_PushButton)绘制按钮外观 - 记录每个单元格按钮的矩形区域（
QRect），存在 model data 里或缓存为QMap<qmodelindex qrect></qmodelindex> - 重写
QTableWidget::mousePressEvent()，用indexAt(pos)获取当前 cell，再用visualRect()+ 偏移算出按钮区域，判断是否点击命中 - 命中后 emit 自定义信号，如
buttonClicked(int row, int col)
这样零 widget 开销，滚动丝滑，内存占用恒定。注意：按钮区域不能硬编码宽高，必须根据字体、padding 动态计算，否则 DPI 缩放或字体变大会错位。
容易被忽略的坑：focus、tab 键和键盘操作
很多人只测鼠标点击，上线后用户按 Tab 切到表格，再按空格想切换复选框——结果没反应。这是因为：
-
QTableWidget默认不把复选框 item 当作可 focus 编辑项，需手动设置item->setFlags(... | Qt::ItemIsEditable) - 空格键触发 toggle 必须在
editorEvent()中捕获QEvent::KeyPress并识别Qt::Key_Space - 若用了自定义 delegate，
createEditor()可以返回nullptr（因为不需要弹出编辑器），但setEditorData()和setModelData()仍需空实现，否则编译警告或运行异常
最简健壮方案：复选框全走 Qt::CheckStateRole + 标准 delegate；按钮交互全部走坐标命中 + 信号解耦。复杂度可控，后期维护成本低，也方便未来迁移到 QTableView + QStandardItemModel。
