Qt无法原生导出Excel，QTableWidget无saveToExcel方法；误用QTextStream写.xlsx会导致乱码，因.xlsx是ZIP+XML结构；推荐QXlsx库（免依赖、纯C++）或CSV方案（需处理特殊字符及BOM）。
Qt 用 QTableWidget 导出 Excel 的常见误区
Qt 本身不提供原生 Excel 写入能力，QTableWidget 也没有 saveToExcel() 这类方法。很多人试图用 QTextStream 直接写 .xlsx 文件，结果打开是乱码或报错 —— 因为 Excel（.xlsx）是 ZIP + XML 结构，不是纯文本格式。
推荐方案：用 QXlsx 库写入 .xlsx 文件
QXlsx 是 Qt 生态中最成熟、免依赖、头文件即用的 Excel 操作库（MIT 协议）。它不调用系统 Excel，也不依赖 COM 或 LibreOffice，纯 C++ 实现。
实操建议：
- 下载
QXlsx源码（GitHub 搜索QtXlsxWriter），把xlsxdocument.h和xlsxdocument.cpp加入项目 - 在 .pro 文件中添加：
QT += core gui widgets（无需额外模块） - 导出逻辑示例（从
QTableWidget到.xlsx）：
#include "xlsxdocument.h"
// ...
void exportToExcel(QTableWidget *table, const QString &filePath) {
QXlsx::Document xlsx;
int row = 1;
for (int r = 0; r < table->rowCount(); ++r) {
int col = 1;
for (int c = 0; c < table->columnCount(); ++c) {
QTableWidgetItem *item = table->item(r, c);
QString text = item ? item->text() : "";
xlsx.write(row, col, text);
++col;
}
++row;
}
xlsx.saveAs(filePath);
}
注意：QXlsx 行列索引从 1 开始，不是 0；空单元格会自动跳过，无需手动判断 nullptr。
导出 CSV 作为轻量替代方案
如果只要兼容性好、能被 Excel 打开的表格，CSV 更简单可靠，且无第三方库依赖。
Excel XLSX Formula Cleanup
下载
诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿
容易踩的坑：
- 字段含逗号、换行或双引号时，必须用双引号包裹，并对内部双引号转义（
"→""） - Windows 上建议用
QTextStream并显式设置编码为UTF-8 with BOM，否则 Excel 可能乱码 - 不要用
QString::split(',')解析原始 CSV —— 它无法处理带逗号的字段
导出示例关键片段：
QFile file(filePath);
if (file.open(QIODevice::WriteOnly)) {
QTextStream out(&file);
out.setCodec("UTF-8");
// 写 BOM
out << "\xEF\xBB\xBF";
for (int r = 0; r < table->rowCount(); ++r) {
QStringList rowItems;
for (int c = 0; c < table->columnCount(); ++c) {
QString s = table->item(r, c) ? table->item(r, c)->text() : "";
if (s.contains(',') || s.contains('\n') || s.contains('"')) {
s.replace('"', "\"\"");
s = '"' + s + '"';
}
rowItems << s;
}
out << rowItems.join(',') << "\n";
}
file.close();
}
QTableView + QSqlQueryModel 导出要注意什么
如果你用的是 QTableView 配合 QSqlQueryModel，不能直接遍历视图的 visual index —— 它可能启用了排序/过滤，行列顺序和底层数据不一致。
正确做法是绕过视图，从模型源头取数据：
- 用
model->record(row)获取整行QSqlRecord，再逐字段调用value(c).toString() - 避免调用
model->data(model->index(r,c), Qt::DisplayRole)，因为某些自定义委托可能返回非原始值 - 如果模型有隐藏列，需提前用
model->headerData(c, Qt::Horizontal, Qt::UserRole)等方式判断是否导出
复杂点在于：QXlsx 对中文支持良好，但 CSV 在 Windows Excel 中默认用 ANSI 打开，BOM 是刚需；而 macOS / Linux 下多数电子表格软件反而会把 BOM 当作脏字符。实际交付前务必在目标环境验证打开效果。
