引言

QXlsx官方显示的例子中，有一个XlsxFactory可以Load xlsx file and display on Qt widgets.但是其包含商业许可…自己写了一个简化版本：可以读取Excel文件，显示到QTableWidget上 (如上图所示)，也可在QTableWidget上进行修改，再保存到Excel文件中。

• 本文只考虑了单元格合并情况，其他格式问题暂未处理 (字体、颜色等)

一、设计思路

• 1. 考虑单元格合并的情况，先读取所有合并的单元格

xlsx = new QXlsx::Document(filename);
CellRange cellrange = xlsx->dimension();
Worksheet *wst = static_cast<QXlsx::Worksheet *>(xlsx->workbook()->sheet(0));
QList<QXlsx::CellRange> qMergedCellsList = wst->mergedCells();   // 获取所有合并的单元格

• 2. 根据读取的文件信息，初始化tableWidget (行列数)，在tableWidget相同位置执行合并操作

ui->tableWidget->setColumnCount(cellrange.columnCount());
ui->tableWidget->setRowCount(cellrange.rowCount());

for(CellRange c : qMergedCellsList) {   // 合并单元格处理ui->tableWidget->setSpan(c.firstRow() - 1, c.firstColumn() - 1,c.lastRow() - c.firstRow() + 1, c.lastColumn() - c.firstColumn() + 1);
}

• 3. 遍历进行数据读取，无脑读取即可 (需注意索引从0开始还是1开始). 被合并的单元格内容为空 (合并的大单元格，只有左上角单元格有值 - 详见Debug输出信息)

for(int i = 1; i <= cellrange.lastRow(); i++){for(int j = 1; j <= cellrange.lastColumn(); j++){QTableWidgetItem *it = new QTableWidgetItem();it->setTextAlignment(Qt::AlignVCenter | Qt::AlignHCenter);it->setText(wst->read(i, j).toString());ui->tableWidget->setItem(i-1, j-1, it);qDebug("%d,%d: %s",i,j,wst->read(i,j).toString().toStdString().c_str());}
}

• 4. 修改数据，然后保存到文件中
     设置Table可编辑：setEditTriggers(QAbstractItemView::AllEditTriggers); // 可编辑

for(int i = 1; i <= cellrange.lastRow(); i++){for(int j = 1; j <= cellrange.lastColumn(); j++){qDebug("%d,%d: %s",i,j,ui->tableWidget->item(i-1, j-1)->text().toStdString().c_str());qDebug("%d,%d: %s",i,j,ui->tableWidget->itemAt(i-1, j-1)->text().toStdString().c_str());wst->write(i, j, ui->tableWidget->item(i-1, j-1)->text());}
}
xlsx->saveAs(file);

使用setSpan合并QTableWidget单元格，会造成itemAt函数一直返回0，使用item获取每一个单元格即可。

QTableWidget表格合并若干问题及解决方法：https://www.cnblogs.com/findumars/p/5422995.html
QTableWidget 成员函数itemAt与item的区别与疑问：https://blog.csdn.net/sddzycnqjn/article/details/24968763/
QTableWidget的获取指定位置项的item和itemAt方法：https://www.cnblogs.com/LaoYuanStudyPython/p/12949250.html

二、核心源码

• Excel文件的读取和保存

connect(ui->action_open, &QAction::triggered, [this](){filename = QFileDialog::getOpenFileName(this, "打开", nullptr, "*.xlsx (*.xlsx)");if(!filename.isEmpty()){// 打开xlsx文件，获取相关信息xlsx = new QXlsx::Document(filename);CellRange cellrange = xlsx->dimension();Worksheet *wst = static_cast<QXlsx::Worksheet *>(xlsx->workbook()->sheet(0));QList<QXlsx::CellRange> qMergedCellsList = wst->mergedCells();   // 获取所有合并的单元格
//            Cell c = wst->cellAt(1, 1);
//            c.format();/// 根据信息初始化Qtablewidgetui->tableWidget->setColumnCount(cellrange.columnCount());ui->tableWidget->setRowCount(cellrange.rowCount());ui->tableWidget->resizeColumnsToContents();ui->tableWidget->setEditTriggers(QAbstractItemView::AllEditTriggers);ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);ui->tableWidget->horizontalHeader()->setDefaultAlignment(Qt::AlignHCenter | Qt::AlignVCenter);//ui->tableWidget->verticalHeader()->hide();for(CellRange c : qMergedCellsList) {   // 合并单元格处理ui->tableWidget->setSpan(c.firstRow() - 1, c.firstColumn() - 1,c.lastRow() - c.firstRow() + 1, c.lastColumn() - c.firstColumn() + 1);}for(int i = 1; i <= cellrange.lastRow(); i++){for(int j = 1; j <= cellrange.lastColumn(); j++){QTableWidgetItem *it = new QTableWidgetItem();it->setTextAlignment(Qt::AlignVCenter | Qt::AlignHCenter);it->setText(wst->read(i, j).toString());ui->tableWidget->setItem(i-1, j-1, it);qDebug("%d,%d: %s",i,j,wst->read(i,j).toString().toStdString().c_str());}}}
});connect(ui->action_save, &QAction::triggered, [this](){if(!xlsx){return;}QString file = QFileDialog::getSaveFileName(this, "打开", filename, "*.xlsx (*.xlsx)");if(!file.isEmpty()){// 打开xlsx文件，获取相关信息CellRange cellrange = xlsx->dimension();Worksheet *wst = static_cast<QXlsx::Worksheet *>(xlsx->workbook()->sheet(0));for(int i = 1; i <= cellrange.lastRow(); i++){for(int j = 1; j <= cellrange.lastColumn(); j++){qDebug("%d,%d: %s",i,j,ui->tableWidget->item(i-1, j-1)->text().toStdString().c_str());qDebug("%d,%d: %s",i,j,ui->tableWidget->itemAt(i-1, j-1)->text().toStdString().c_str());wst->write(i, j, ui->tableWidget->item(i-1, j-1)->text());}}xlsx->saveAs(file);}
});

三、其他参考链接

官方例子：https://gitcode.com/qtexcel/qxlsx/blob/master/Example.md
QT读取Excel表格内容到Table Widget：https://blog.csdn.net/qq_16186465/article/details/125555628
QXlsx对合并单元格的处理：https://blog.csdn.net/qq_36391817/article/details/84032788
Qt-QXLS应用 读写Excel常用函数 (包括表单、样式、图、宏操作等，比较全)：https://www.cnblogs.com/fengye2021/p/15363391.html