Qt C++中如何将QTableWidget内容保存到MySQL数据库

在.NET环境下MySqlCommandBuilder配合DataAdapter.Update的核心逻辑是：自动根据离线数据集的行状态（新增/修改/删除）生成对应SQL，批量提交变更到数据库。Qt框架下没有直接针对QTableWidget的一键同名方法，因为QTableWidget是纯UI展示组件，本身不维护和数据库的绑定关系、不追踪数据变更状态，有两种成熟实现方案：

方案1：使用QSqlTableModel（和.NET逻辑完全等价，官方推荐） #

这是Qt Model/View架构下对应.NET DataSet+DataAdapter的标准实现，不需要手动遍历单元格、不需要自己写增删改SQL，框架自动追踪数据变更、生成对应数据库命令，是最优选择。

实现代码 #

首先确保你已经正确配置Qt的MySQL驱动、完成数据库连接：

// 初始化模型，绑定到MySQL中名为item的目标表
QSqlTableModel *model = new QSqlTableModel(this, db); // db为已成功打开的QSqlDatabase实例
model->setTable("item");
// 设置手动提交策略，和.NET中先修改离线数据、最后统一调用Update提交的逻辑一致
model->setEditStrategy(QSqlTableModel::OnManualSubmit);
model->select(); // 拉取数据库中已有数据到模型

// 将模型绑定到表格视图，不需要手动给QTableWidget逐单元格填数据
ui->tableView->setModel(model);

需要保存数据时，一行核心调用即可提交所有变更：

if (!model->submitAll()) {
    qDebug() << "数据保存失败：" << model->lastError().text();
}

该方法会自动识别模型中所有新增、修改、删除的行，自动生成对应的INSERT/UPDATE/DELETE语句执行，和你贴的C#/VB.NET代码功能完全一致。

方案2：必须使用QTableWidget时的优化实现 #

如果现有项目已经基于QTableWidget开发、无法切换为QTableView+QSqlTableModel的架构，不要用全表遍历的写法——全表遍历无法区分行状态、会重复提交未修改的数据，性能差还容易出错。

优化思路 #

• 通过QTableWidget的itemChanged、rowsInserted、rowsRemoved信号，提前记录所有发生改动的行号、被删除行的主键ID，保存时只处理变更部分
• 用SQL预处理语句避免注入、提升执行效率
• 开启数据库事务做批量提交，大幅提升写入速度

参考代码 #

// 提前初始化预处理SQL，替换字段名、表名为你实际的库表结构
QSqlQuery insertQuery(db);
insertQuery.prepare("INSERT INTO item (field1, field2, field3) VALUES (?, ?, ?)");
QSqlQuery updateQuery(db);
updateQuery.prepare("UPDATE item SET field1=?, field2=?, field3=? WHERE id=?"); // id为主键
QSqlQuery deleteQuery(db);
deleteQuery.prepare("DELETE FROM item WHERE id=?");

// 开启事务
db.transaction();

// 处理新增、修改的行，changedRows为你之前通过信号记录的变更行号集合
for (int row : changedRows) {
    if (/* 判断该行是新增行，未绑定数据库主键 */) {
        insertQuery.addBindValue(ui->tableWidget->item(row, 0)->text());
        insertQuery.addBindValue(ui->tableWidget->item(row, 1)->text());
        insertQuery.addBindValue(ui->tableWidget->item(row, 2)->text());
        insertQuery.exec();
    } else {
        updateQuery.addBindValue(ui->tableWidget->item(row, 0)->text());
        updateQuery.addBindValue(ui->tableWidget->item(row, 1)->text());
        updateQuery.addBindValue(ui->tableWidget->item(row, 2)->text());
        updateQuery.addBindValue(/* 该行存储的数据库主键id */);
        updateQuery.exec();
    }
}
// 处理被删除的行，deletedIds为你记录的被删行主键集合
for (int id : deletedIds) {
    deleteQuery.addBindValue(id);
    deleteQuery.exec();
}

// 统一提交事务，失败则回滚
if (!db.commit()) {
    db.rollback();
    qDebug() << "保存失败，事务已回滚：" << db.lastError().text();
}

注意事项 #

• 优先选择QSqlTableModel方案，避免手动维护数据状态、重复造轮子
• 所有数据库写入操作不要用字符串拼接SQL，必须用预处理语句，避免SQL注入风险
• 批量写入一定要开启事务，否则单条语句自动提交的性能会差一个数量级

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