MyBatis-Plus SQL日志打印配置与优化实践
2026/10/14 7:35:24
1. 项目概述：QT与QXlsx的Excel操作方案
在数据处理领域，Excel文件的操作一直是刚需。传统方案依赖微软COM组件或Python库，但在C++生态中一直缺乏优雅的解决方案。QT框架配合QXlsx库的出现，彻底改变了这一局面。这套组合不仅能实现基础的读写功能，更支持样式调整、公式计算、图表生成等高级操作，且完全跨平台——这正是我三年前接手金融数据分析项目时选择它的原因。
2. 环境搭建与配置要点
2.1 QT环境准备
推荐使用QT 5.15+版本，这是长期支持版本中最稳定的选择。安装时务必勾选：
- MSVC 2019编译器套件（Windows平台）
- MinGW 8.1+（跨平台开发）
- CMake构建工具（新版QXlsx已转向CMake）
注意：避免使用QT 6.x初始版本，部分API兼容性尚未完全稳定
2.2 QXlsx的三种集成方式
- 源码集成（推荐）
git clone https://github.com/QtExcel/QXlsx.git cd QXlsx mkdir build && cd build qmake ../QXlsx.pro make -j8编译后生成的libQXlsx.a可直接链接到项目
- 子模块集成
git submodule add https://github.com/QtExcel/QXlsx.git适合长期维护的大型项目
- 手动引入（适合快速验证） 直接复制QXlsx/src目录到项目路径，在.pro文件添加：
include($$PWD/src/xlsx/qxlsx.pri)3. 核心功能实现解析
3.1 基础读写操作
创建带样式的工作表示例：
QXlsx::Document xlsx; xlsx.addSheet("DataReport"); // 设置表头样式 QXlsx::Format headerFormat; headerFormat.setFontBold(true); headerFormat.setFontColor(Qt::blue); headerFormat.setFillPattern(Format::PatternSolid); headerFormat.setPatternBackgroundColor(QColor(230,230,250)); xlsx.write(1, 1, "ID", headerFormat); xlsx.write(1, 2, "Value", headerFormat); // 批量写入数据 for(int row=2; row<=100; ++row){ xlsx.write(row, 1, row-1); // ID列 xlsx.write(row, 2, QRandomGenerator::global()->bounded(1000)); } // 保存时自动识别后缀 if(!xlsx.saveAs("report.xlsx")){ qDebug() << "保存失败：" << xlsx.errorString(); }3.2 高级功能实现
3.2.1 公式计算
// 设置SUM公式 xlsx.write(102, 2, "=SUM(B2:B101)"); // 获取计算结果（需显式计算） xlsx.calculateFormulaValue(); QVariant result = xlsx.read(102, 2);3.2.2 图表生成
QXlsx::Chart *chart = xlsx.insertChart(5, 5, QSize(600, 300)); chart->setChartType(Chart::CT_Line); chart->addSeries(CellRange("B2:B101")); chart->setAxisTitle(Chart::Left, "Value"); chart->setAxisTitle(Chart::Bottom, "Index");4. 性能优化实践
4.1 大数据量处理方案
测试数据表明，当行数超过10万时，需要特殊处理：
- 禁用自动计算
xlsx.setDocumentProperty("calcMode", "manual");- 分块写入数据
const int CHUNK_SIZE = 5000; for(int i=0; i<totalRows; i+=CHUNK_SIZE){ QXlsx::CellRange range(i+1, 1, qMin(i+CHUNK_SIZE, totalRows), cols); xlsx.writeBlock(range, dataBlock); }- 使用流式API（QXlsx特有）
QXlsx::SheetDataWriter writer(&xlsx, "BigData"); writer.setRowCacheSize(200); // 缓存行数 for(auto row : dataRows){ writer.addRow(row); } writer.finalize();4.2 内存管理技巧
- 及时释放不再使用的Worksheet对象
xlsx.deleteSheet("TempSheet"); // 显式删除临时表- 对于只读操作，使用：
QXlsx::Document xlsx("input.xlsx", QXlsx::Document::ReadOnly);5. 实战问题排查指南
5.1 常见错误代码表
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 文件无法打开 | 文件被其他进程占用 | 检查杀毒软件/Excel进程 |
| 中文乱码 | 编码问题 | 设置QTextCodec::setCodecForLocale |
| 公式不计算 | 未显式调用计算 | 执行calculateFormulaValue() |
| 样式失效 | 格式对象被提前释放 | 保持Format对象生命周期 |
5.2 调试技巧
- 启用详细日志：
QXlsx::Document::setLogLevel(QXlsx::LogLevelDebug);- 检查隐藏的工作表：
foreach(auto name, xlsx.sheetNames()){ if(name.startsWith("_")){ qDebug() << "发现隐藏表：" << name; } }6. 扩展应用场景
6.1 报表自动化系统
结合QT的定时器功能，可实现：
QTimer::singleShot(3600000, [](){ generateDailyReport(); });典型应用场景：
- 每日凌晨生成前日销售报表
- 每小时输出系统监控数据
- 实时导出数据库查询结果
6.2 与数据库联动
SQL查询结果直接导出示例：
QSqlQuery query; query.exec("SELECT * FROM transactions"); QXlsx::Document xlsx; int row = 1; while(query.next()){ for(int col=0; col<query.record().count(); ++col){ xlsx.write(row, col+1, query.value(col)); } ++row; } xlsx.saveAs(QDateTime::currentDateTime().toString("yyyyMMdd") + "_export.xlsx");在实际项目中，我发现QXlsx对合并单元格的处理有个隐藏特性：当合并区域超过1000行时，建议先拆分为多个小区域合并，否则可能引发性能问题。另外，通过重载QXlsx::AbstractSheetHandler可以实现自定义的数据加密存储，这在金融领域特别实用。