简介：面向 Qt 初学者和需要在桌面应用中接入 Excel 表格读取与展示功能的开发者，这套内容给出读取 Excel 并显示到 TableWidget 的封装思路与可运行演示工程，可用于数据导入、表格预览等基础场景，减少重复搭建解析逻辑与界面联动的工作。压缩包共 8 个文件，以 3 个 cpp 源文件和 2 个 h 头文件为主体，另含界面、工程及用户配置类文件，整体约 8KB，结构轻便，便于对照配置快速测试。已有约 3000 人学习下载，说明该主题有持续参考需求。读者可获取封装类与界面配合的完整示例、Qt5 工程组织方式以及表格数据在 TableWidget 中呈现的实现参考，适合按项目配置运行并在此基础上做二次开发或排错借鉴。

1. 一个 3 万行的 xlsx 让界面卡了 8 秒：先把读取路径定清楚

上周帮人看一个 Qt 客户端，点「导入 Excel」之后窗口直接白屏，任务管理器里 Excel.exe 还赖着不走，用户以为程序崩了。拆开看，问题不在 Excel，也不在 TableWidget，而在于它是一格一格querySubObject("Cells(int,int)")去取的——3 万行 × 12 列，九十万次 COM 往返，8 秒已经算客气。这份资源正好对症：一份 Qt 读取 Excel 并显示到 TableWidget 的封装，加一个能直接跑的 demo，封装层把「打开、取表、读区域、类型归一化、释放」这几步收进一个类，demo 负责把结果灌进表格并处理刷新与列宽。它适合两类人：一类是第一次在 Qt 里接 Excel、被 COM 的对象释放和日期格式绕晕的新手；另一类是手里已经有能跑的代码、但一到几万行就假死、想知道瓶颈到底在哪的熟手。下面按「选哪条路 → 怎么封 → 怎么显示 → 坑在哪」四段拆，代码都能直接抄。

2. 三条读取路线怎么选：QAxObject、QXlsx 与 ODBC 的边界

在写封装之前必须先定路线，因为封装的接口设计完全取决于底层能力。Qt 读 Excel 主流就三条路，各自的适用面差别很大，选错了后面全是补丁。

2.1 QAxObject 走 COM：能力最全，依赖最重

QAxObject 是 Qt 对 ActiveX 的包装，本质是在本机起一个 Excel 进程，通过 COM 接口跟它对话。它的好处是「Excel 能做的它都能做」：合并单元格、公式计算结果、单元格底色、批注、多级表头，甚至图表对象都能摸到。缺点是三件事你必须接受：目标机器上得装着 Excel 或兼容的办公套件；每次new QAxObject("Excel.Application")都要启动一个进程，冷启动 1～3 秒很正常；以及它是 Windows 专属，跨平台需求直接出局。

最小可用的一段是这样：

// 打开工作簿并一次性取回整个区域的二维数组 QAxObject* excel = new QAxObject("Excel.Application", this); excel->setProperty("Visible", false); // 不弹窗，否则用户会看到表格乱闪 excel->setProperty("DisplayAlerts", false); // 关掉"是否覆盖"之类的模态框，否则会卡死主线程 QAxObject* workbooks = excel->querySubObject("Workbooks"); QAxObject* workbook = workbooks->querySubObject("Open(const QString&)", filePath); QAxObject* sheets = workbook->querySubObject("Sheets"); QAxObject* sheet = sheets->querySubObject("Item(int)", 1); // 1 基，不是 0 QAxObject* range = sheet->querySubObject("Range(const QString&)", "A1:L30000"); QVariant value = range->property("Value"); // 关键：一次拿整个区域

Range("A1:L30000").Value返回的是一个嵌套的QVariantList，外层是行、内层是列。这一步的意义在于把九十万次 COM 调用压成一次，读取耗时通常从秒级掉到百毫秒级。参数上有两个容易写错的地方：Item(int)的索引从 1 开始，传 0 会拿到空指针；Open的路径要用QDir::toNativeSeparators()转成反斜杠，否则含中文或空格的路径在某些环境下会静默失败，返回一个空对象而不是报错。

需要留意的是返回值形状不固定。当你取的区域只有一行或一列时，Excel 会退化成一个一维列表甚至标量，代码里必须判断value.type()再决定怎么遍历，这一点后面 3.2 会展开。

2.2 QXlsx 纯 Qt 解析：轻，但要认它的能力边界

xlsx 文件本身就是一个 zip 包，里面是 OpenXML 格式的 xml。QXlsx 这类库直接解压解析，不启动任何外部进程，所以它跨平台、启动快、不依赖 Office，而且能读也能写。如果你的场景是「读一批固定格式的报表」「导出数据给业务方」，它是更省心的选择。

集成方式按构建系统分两种：

# CMake：把 QXlsx 源码目录直接加进来，避免动态库版本对不齐 add_subdirectory(3rdparty/QXlsx) target_link_libraries(YourApp PRIVATE QXlsx::QXlsx)

# qmake：直接包含 pri include(3rdparty/QXlsx/QXlsx.pri)

读取侧非常直白：

QXlsx::Document doc(filePath); if (!doc.load()) { // load 返回 false 就是文件损坏或不是 xlsx return ErrorCode::OpenFailed; } QStringList names = doc.sheetNames(); // 拿所有 sheet 名，供下拉框用 doc.selectSheet(names.first()); QXlsx::CellRange dim = doc.dimension(); // 有效数据范围，别用 rowCount 硬猜 for (int r = dim.firstRow(); r <= dim.lastRow(); ++r) { for (int c = dim.firstColumn(); c <= dim.lastColumn(); ++c) { QVariant v = doc.read(r, c); // 空格子返回无效 QVariant } }

它的边界得说清楚：只支持 xlsx（以及部分 xlsm），老的二进制 .xls 读不了；单元格样式、图表、条件格式这类东西它拿不全；超大文件会整份载入内存，几十万行的表要掂量一下内存占用。所以选型时先问一句「源文件是不是别人从老系统导出的 .xls」，是的话这条路直接堵死。

2.3 ODBC 查询式读取：适合只读大表和 SQL 过滤

第三条路是把 Excel 当成数据库，通过 ODBC 驱动用 SQL 查。它的独特价值在于可以在读取阶段就做过滤和排序，比如只取WHERE 状态='待处理'，避免把整张表拉进内存。驱动装好之后代码很短：

QSqlDatabase db = QSqlDatabase::addDatabase("QODBC", "excel_conn"); // 注意：驱动名和文件后缀要对应，xlsx 走下面的写法 QString conn = QString( "DRIVER={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsb)};" "DBQ=%1;ReadOnly=1;").arg(filePath); db.setDatabaseName(conn); if (!db.open()) { /* 报错通常是驱动没装或位数不匹配 */ } QSqlQuery q(db); q.exec("SELECT * FROM [Sheet1$]"); // 表名 = sheet 名 + $ while (q.next()) { /* 按列取值 */ }

表名后面那个$是硬性要求，漏了会报「找不到表」。另外 Excel 驱动靠前 8 行推断列类型，如果某一列前几行是数字、后面混进了「暂无」，整列可能被判定为文本或直接读出空值，这是它最不靠谱的地方。所以 ODBC 适合「数据规整、只需要部分行」的场景，不适合当通用读取层。

三条路的对比放在一张表里更直观：

封装设计上我的做法是：定义一个IExcelReader抽象接口，把load、sheetNames、rows三件事抽出来，QAxObject 和 QXlsx 各写一个实现，运行时按文件后缀选。这样业务代码不关心底层，将来换库只改一个工厂函数。

3. 封装一层 ExcelReader：接口、错误码与类型归一化

原生的 QAxObject 调用散落在业务代码里是最容易失控的写法——释放漏一个，Excel.exe 就留在后台；类型判断写错一处，日期全变数字。封装的目标不是「好看」，而是把这三类风险收敛到一个文件里。

3.1 头文件设计：把 Sheet、单元格类型与错误码定死

接口设计的第一原则是「错误必须能传出来」。很多人封装的load()返回 bool，失败之后只能靠猜，最后变成在代码里到处qDebug()。我一般会定义一组明确的错误码，并且约定一个统一的数据出口：所有单元格值最终都归一化成QVariant，附带一个类型标记。

class ExcelReader : public QObject { Q_OBJECT public: enum ErrorCode { NoError = 0, FileNotFound, // 路径不存在或没权限 OpenFailed, // 文件损坏 / 被占用 / 驱动缺失 SheetNotFound, // 指定的 sheet 名不存在 EmptySheet, // 有 sheet 但没有任何有效单元格 EngineMissing // QAxObject 模式下没装 Excel }; Q_ENUM(ErrorCode) explicit ExcelReader(QObject* parent = nullptr); ~ExcelReader() override; bool load(const QString& path, const QString& sheetName = QString()); QStringList sheetNames() const; // 返回按行组织的字符串矩阵，空单元格为空串，日期已格式化 const QVector<QStringList>& rows() const { return m_rows; } int columnCount() const { return m_columnCount; } ErrorCode lastError() const { return m_err; } QString lastErrorText() const; signals: void errorOccurred(ErrorCode code, const QString& detail); private: QVector<QStringList> m_rows; int m_columnCount = 0; ErrorCode m_err = NoError; };

这里有两个决定值得展开。第一，rows()直接返回QStringList而不是QVariant，因为在「显示到表格」这个场景里，最终产物一定是字符串，提前归一化能省掉 UI 层一堆toString()和分支判断；如果业务还要用原始数值做计算，那就再加一个rawRows()返回QVariant，两条出口并存，别混在一起。第二，sheetName为空时取第一个 sheet，这是最常见的调用方式，但一定要在日志里打出来实际用的是哪个，否则用户传了个错名字、程序默默读了第一页，排查起来非常费劲。

错误码到文案的映射建议单独一个函数，别散在 UI 里：

QString ExcelReader::lastErrorText() const { switch (m_err) { case FileNotFound: return QStringLiteral("文件不存在或无访问权限"); case OpenFailed: return QStringLiteral("文件无法打开，可能已损坏或被其他程序占用"); case SheetNotFound: return QStringLiteral("指定的工作表不存在"); case EmptySheet: return QStringLiteral("工作表中没有数据"); case EngineMissing: return QStringLiteral("未检测到可用的表格引擎"); default: return QString(); } }

3.2 读取实现：一次性取 Range 而不是逐格

这是整个封装里性能差别最大的一处。QAxObject 模式下，正确做法是先算出有效区域，再一次性把Value取回来。

bool ExcelReader::load(const QString& path, const QString& sheetName) { m_rows.clear(); m_columnCount = 0; m_err = NoError; QFileInfo fi(path); if (!fi.exists()) { m_err = FileNotFound; return false; } QAxObject* excel = new QAxObject("Excel.Application"); if (excel->isNull()) { // 没装 Excel 时这里就是空 delete excel; m_err = EngineMissing; return false; } excel->setProperty("Visible", false); excel->setProperty("DisplayAlerts", false); QAxObject* workbooks = excel->querySubObject("Workbooks"); QAxObject* workbook = workbooks->querySubObject( "Open(const QString&)", QDir::toNativeSeparators(fi.absoluteFilePath())); if (!workbook || workbook->isNull()) { excel->dynamicCall("Quit()"); delete excel; m_err = OpenFailed; return false; } QAxObject* sheets = workbook->querySubObject("Sheets"); QAxObject* sheet = nullptr; if (sheetName.isEmpty()) { sheet = sheets->querySubObject("Item(int)", 1); } else { sheet = sheets->querySubObject("Item(const QString&)", sheetName); if (!sheet || sheet->isNull()) { // 名字不存在时 querySubObject 返回空 workbook->dynamicCall("Close(bool)", false); excel->dynamicCall("Quit()"); delete excel; m_err = SheetNotFound; return false; } } // UsedRange 比整表扫描快得多，它只覆盖真正有内容的矩形区域 QAxObject* used = sheet->querySubObject("UsedRange"); QAxObject* range = used->querySubObject("Value"); // 注意：Value 是属性不是对象 QVariant value = used->property("Value"); // ... 见 3.3 的解析与释放 }

几个参数值得说明。Visible=false不只是为了不弹窗，还能避免焦点被抢走导致主窗口失去激活态。DisplayAlerts=false是防死锁的关键：如果打开的文件带外部链接，Excel 会弹一个「是否更新链接」的模态框，而 COM 调用是同步的，主线程就此卡住，用户只看到程序未响应。UsedRange则解决了「不知道有多少行」的问题——它返回的区域可能比真实数据略大（比如曾经编辑过又删掉的行会被算进去），所以解析时要跳过整行为空的记录。

区域大于单行单列时，property("Value")返回的是QVariantList套QVariantList。遍历时用两层toList()，但要注意内层元素可能是标量，直接toList()会得到空，所以必须先判类型——这就是下一节要处理的事。

3.3 类型归一化：数字、日期、布尔与空单元格

COM 传回来的值类型五花八门：整数可能是int，小数是double，日期是QDateTime，也可能因为区域设置变成double的序列号（1900 年基准，45231 代表某一天），布尔是bool，空单元格是无效QVariant。如果直接toString()就塞进表格，日期那列会变成「45231」，整数那列可能变成「1.0」。

QString ExcelReader::cellToText(const QVariant& v) { if (!v.isValid() || v.isNull()) return QString(); // 空单元格统一成空串 switch (v.type()) { case QVariant::DateTime: { QDateTime dt = v.toDateTime(); return dt.time() == QTime(0, 0) ? dt.toString("yyyy-MM-dd") : dt.toString("yyyy-MM-dd HH:mm:ss"); } case QVariant::Date: return v.toDate().toString("yyyy-MM-dd"); case QVariant::Double: { double d = v.toDouble(); // 整数值的小数去掉尾巴，避免 12 显示成 12.0 if (qFuzzyCompare(d, qRound64(d) * 1.0)) return QString::number(qRound64(d)); return QString::number(d, 'g', 10); // 10 位有效数字，够财务场景 } case QVariant::Bool: return v.toBool() ? QStringLiteral("是") : QStringLiteral("否"); default: return v.toString().trimmed(); // 文本去掉首尾空白 } }

参数上有个取舍：QString::number(d, 'g', 10)里的 10 是有效数字位数，调大到 15 会暴露浮点误差（0.1+0.2 那类），调小到 6 会丢精度，10 位对金额和测量值都够用。日期格式不建议用系统本地化格式，因为同一个文件在不同机器上会显示成不同样子，导出核对时容易出岔子，固定成yyyy-MM-dd最稳。

还有一个隐蔽情况：如果toDouble()的结果落在 1～2958465 这个区间且单元格格式是日期，说明拿到的是未转换的序列号。稳妥的做法是同一行先看有没有QDateTime类型，没有再用数值区间兜底判断，但别对纯数字列无脑套用——发票号恰好是 45231 的时候，你会把它变成 2023 年的某一天。这种「看起来像日期」的误判，翻车过的人都懂。

释放顺序同样属于封装的一部分，写错就是进程残留：

// 释放必须自内向外，先关工作簿再退应用，最后删顶层对象 workbook->dynamicCall("Close(bool)", false); // false = 不保存，避免弹保存框 excel->dynamicCall("Quit()"); delete used; delete range; delete sheet; delete sheets; delete workbook; delete workbooks; delete excel;

delete的顺序反过来也无妨，但excel->dynamicCall("Quit()")必须在删除子对象之前调用，否则 Excel 进程收不到退出指令，就成了任务管理器里那个删不掉的幽灵。

4. 灌进 QTableWidget：从 8 秒到 300 毫秒的批量填充

数据读出来只完成了一半，剩下那一半在 UI 层。QTableWidget 的默认行为对批量写入极不友好，每一行setRowCount、每一次setItem都可能触发重排和重绘，几千行就能看出卡顿。

4.1 关掉刷新与排序：三个必须成对出现的开关

核心思路是把所有会触发布局的副作用先关掉，填完再统一打开。

void MainWindow::fillTable(const QVector<QStringList>& rows) { QTableWidget* t = ui->tableWidget; t->setUpdatesEnabled(false); // 暂停重绘 t->setSortingEnabled(false); // 必须关，否则每 setItem 都重新排序 t->blockSignals(true); // 屏蔽 itemChanged 等信号回调 t->clearContents(); t->setRowCount(rows.size()); // 一次性定行数，别在循环里 setRowCount t->setColumnCount(rows.isEmpty() ? 0 : rows.first().size()); for (int r = 0; r < rows.size(); ++r) { const QStringList& line = rows.at(r); for (int c = 0; c < line.size(); ++c) { t->setItem(r, c, new QTableWidgetItem(line.at(c))); } } t->blockSignals(false); t->setSortingEnabled(true); // 数据填完再开，用户点表头才生效 t->setUpdatesEnabled(true); t->viewport()->update(); }

三个开关缺一不可。setUpdatesEnabled(false)省的是重绘，3 万行大约能省掉七成时间；setSortingEnabled(false)省的是比较，开着排序时每次setItem都会触发一次插入排序，是卡顿的主要来源；blockSignals则防止你自己的槽函数被调用几万次，比如有人监听itemChanged做实时校验，不屏蔽的话这里会直接爆掉。另外setRowCount一定要在循环外调用，放在循环里每次都会重建内部索引。

实测数据供参考：3 万行 × 12 列，逐格setItem且三个开关全开，约 8～12 秒；全关之后 300～600 毫秒。差距主要来自重绘和排序，不是new QTableWidgetItem本身。

4.2 表头、对齐与列宽：让数字列看起来像数字

数据灌进去之后，默认所有单元格左对齐、列宽 100，读起来很难受。列宽自适应有三种写法，代价差很多：resizeColumnsToContents()会遍历所有行算最大宽度，3 万行要一秒多；改成只采样前 200 行再取最大值，效果肉眼看不出来但快得多。

// 只采样前 200 行估算列宽，兼顾观感和速度 for (int c = 0; c < t->columnCount(); ++c) { int w = t->horizontalHeader()->sectionSize(c); int sample = qMin(t->rowCount(), 200); for (int r = 0; r < sample; ++r) { if (auto* it = t->item(r, c)) w = qMax(w, t->fontMetrics().horizontalAdvance(it->text()) + 24); } t->setColumnWidth(c, qMin(w, 320)); // 上限 320，防止长文本撑爆屏幕 }

对齐规则按内容判断，别一刀切。数值列右对齐是财务表的习惯，能让小数点对齐；文本左对齐；日期和编码类居中也行，但更重要的是别让「00123」被当成数字——Excel 里以文本存储的编号，读出来是字符串，但如果某一行被 Excel 自动转成了数字，前导零就没了，这不是 UI 能修的，得在读取层给出提示。

表头文本直接从第一行取是个常见做法，但要注意两点：如果文件根本没有表头，第一行数据会被吃掉；如果表头有合并单元格，取到的文本可能只落在第一列。稳妥做法是给load()加个headerRow参数，默认 1，特殊文件传 0 表示无表头。

4.3 大表分页与懒加载：超过 5 万行的处理

QTableWidget 不是虚拟化控件，每个单元格都是一个真实的QTableWidgetItem对象。5 万行 × 20 列就是一百万个对象，内存会飙到几百兆，滚动明显掉帧。到这个量级，思路得换。

第一种是分页。读完之后只把当前页（比如 1000 行）灌进表格，翻页时再换一批：

void MainWindow::showPage(int page) { const int pageSize = 1000; int begin = page * pageSize; int end = qMin(begin + pageSize, m_allRows.size()); QVector<QStringList> slice = m_allRows.mid(begin, end - begin); fillTable(slice); // 复用 4.1 的填充逻辑 ui->pageLabel->setText(QString("%1 / %2").arg(page + 1) .arg((m_allRows.size() + pageSize - 1) / pageSize)); }

数据本身留在内存里的m_allRows，表格只做展示窗口。分页的代价是搜索要跨页，得自己在数据层过滤完再刷新。

第二种是换控件。行数稳定在十万以上时，QTableView + 自定义QAbstractTableModel才是正解，模型只提供data()，视图按需索取可见行，内存和滚动都是常数级。从 QTableWidget 迁到 QTableView 的改动集中在两处：fillTable换成模型的setData，取值换成data(index, Qt::DisplayRole)。如果这个导入功能以后要支持列排序、列筛选，早点换比晚点换省事。

临时方案也有：数据照常读进来，但表格只显示前 5000 行，底部提示「仅显示前 5000 行，完整数据请导出」。这种做法在内部工具里被广泛采用，用户其实很少真去翻第 8000 行。

5. 避坑清单：进程残留、日期漂移与位数不匹配的五个现场

这一节的每一条都是实际调试出来的，不是从文档里抄的。按「现象 → 原因 → 解决」记，遇到时直接对号入座。

5.1 关掉程序后 Excel.exe 还在任务管理器里

现象：点关闭按钮，主窗口没了，任务管理器里EXCEL.EXE依然在，再打开几次就攒出四五个，机器越来越慢。

原因：COM 对象没有全部释放。querySubObject每次返回一个新的包装对象，它们不是 Qt 父子关系里的子对象，delete excel不会连带清理workbook、sheets、range。只要有任何一个没删，Excel 进程就认为还有客户端连着，不退出。

解决：把所有querySubObject的返回值都记下来，在退出时自内向外delete，并保证Quit()在删除之前调用。更稳的写法是用QScopedPointer或者自己写一个小 RAII 包装，在析构里统一释放。另外注意异常路径——return false之前也要走一遍释放，很多人只在成功路径上写了清理，一报错就漏。

5.2 日期列读出来是 45231 这样的数字

现象：表格里日期列显示成一串五位数字，导出核对时对不上。

原因：Value返回的类型取决于单元格格式和区域设置。有些环境下 Excel 返回的是double序列号而不是QDateTime，而代码里只判了QDateTime，其余走toString()，于是序列号原样输出。

解决：在cellToText里对double做区间判断（1～2958465 且不是纯编号列），按 1899-12-30 为基准换算成日期。但必须配合列级判断——如果整列都是数值、没有一个是QDateTime，那多半真的就是数字列，不要转。最保险的做法是读取时额外拿一次单元格的NumberFormat，含y、m、d的才按日期处理。

5.3 报错「未找到数据源名称且未指定默认驱动程序」

现象：ODBC 路线，代码没问题，db.open()一直返回 false，错误信息就是这个。

原因：驱动位数和 Qt 位数不匹配。32 位的 Qt 程序只能加载 32 位的 ODBC 驱动，机器上装的是 64 位 Office，注册表里就只有 64 位驱动，两边对不上。

解决：先确认自己 Qt 的位数（qmake -query QT_ARCH或看编译链），再装对应位数的驱动组件。如果两个位数都要支持，就得在两套环境里分别部署。这条没有代码层面的绕过办法，只能靠部署时把环境摸清楚。

5.4 含中文或空格的路径打开失败，但不报错

现象：Workbooks.Open传了一个带中文目录的路径，返回的对象是空的，程序继续往下走，然后在sheet那里崩溃。

原因：路径没做本地化分隔符转换，或者传参时被当成宽字符处理出了问题。COM 对路径比较挑剔，正斜杠在部分版本上不认。

解决：统一走QDir::toNativeSeparators(QFileInfo(path).absoluteFilePath())，并且在使用querySubObject之后立刻判空——isNull()为真就直接返回OpenFailed，别让空指针流到下一层。

5.5 空单元格被当成 0 参与统计

现象：某列有一半是空的，汇总出来平均值偏低，查了半天发现空单元格变成了 0。

原因：QVariant().toInt()返回 0 且不报错。代码里对每格都调toInt()求和，空值自然算成了 0。

解决：所有取值入口先判isValid()和isNull()，空值返回空字符串并单独计数。显示层用空串，统计层跳过空行，两条路径分开处理。这个坑在「导入后自动算合计」的功能里几乎必踩。

6. 把读取放进线程：12 万行导出的验证与收尾技巧

前面所有代码都跑在主线程，3 万行以内感觉不出来，一旦到十万行级别，即使做了批量填充，读取阶段那几百毫秒到一两秒的阻塞仍然会让界面掉帧。我的做法是把ExcelReader移到工作线程，主线程只负责接结果。

6.1 线程边界：解析在子线程，界面只在主线程碰

Qt 的规则很明确：任何QWidget及其子类只能在主线程操作。所以线程里绝不能碰 TableWidget，只做纯数据解析，通过信号把QVector<QStringList>传回来。

class ExcelLoadTask : public QObject { Q_OBJECT public slots: void doLoad(const QString& path, const QString& sheet) { ExcelReader reader; // 栈上对象，随线程生命周期结束 bool ok = reader.load(path, sheet); emit finished(ok, reader.rows(), reader.lastErrorText()); } signals: void finished(bool ok, QVector<QStringList> rows, QString err); }; // 主线程侧 QThread* th = new QThread(this); auto* task = new ExcelLoadTask; task->moveToThread(th); connect(th, &QThread::started, task, [=]{ task->doLoad(path, sheet); }); connect(task, &ExcelLoadTask::finished, this, &MainWindow::onLoaded); // 自动排队回主线程 connect(task, &ExcelLoadTask::finished, th, &QThread::quit); th->start();

QVector<QStringList>作为信号参数需要qRegisterMetaType注册（或者用QVariant包一层），否则跨线程排队时会丢参数并打一条警告。另外注意ExcelReader里的 QAxObject 在子线程创建是可行的，但必须保证它在该线程内用完并释放——跨线程使用 COM 对象是另一个深渊，不要尝试。

6.2 用行数与抽样校验做回归验证

导入功能最怕的不是慢，是「看起来成功了但数据少了两行」。我一般会在读取完成后做两道校验：一是把有效行数与UsedRange的行数对比，差值超过 5% 就打日志；二是抽样取首行、末行和中间一行的第一个单元格，跟源文件人工核对一次。

这套校验跑一遍不到十毫秒，但能挡掉大部分「静默失败」。我现在的习惯是每次改完读取层，先拿一份 12 万行、掺杂空行和日期列的真实表跑一遍，盯着日志里的行数差和空值比例，两个数对上了才敢提交。血泪经验是：跳过这一步省下的十分钟，通常会变成上线后两小时的排查。希望帮到你。

本文还有配套的精品资源，点击获取