Qt 中如何操作 Excel 表格：主流开源库说明介绍与 QXlsx 库应用全解析

前言

在 Qt 应用开发中，"数据导出为表格""读取 Excel 数据进行分析" 是高频需求 ------ 从管理系统的报表生成，到科研工具的数据整理，再到工业软件的日志归档，几乎都离不开 Excel 交互。但 Qt 原生并未提供 Excel 操作模块，因此选择合适的开源库成为关键。

本文将系统梳理 Qt 生态中几种主流 Excel 操作方案（QXlsx、QAxObject、LibXL、ODBC），对比其核心差异与适用场景；并以跨平台、无依赖、轻量级的 QXlsx开源库 为核心，实现 Excel 的 "创建 - 读写 - 格式美化" 全流程。

一、Qt 操作 Excel 的 4 种主流方案对比

在选择 Excel 操作库前，需先明确项目的核心约束：是否需要跨平台？是否依赖本地 Excel 安装？是否需要格式控制或公式计算？不同库的设计理念差异极大，选错方案可能导致后期重构成本飙升。以下是 4 种主流方案的深度解析：

1. QXlsx（推荐）

简介 ：QXlsx 是一个轻量级开源库（MIT 协议），基于 Qt 框架实现，无需依赖 Microsoft Excel 或其他第三方软件，纯 C++ 实现 Excel 文件（.xlsx）的读写和格式控制。它是从早期的QtXlsxWriter fork 而来，目前维护活跃，兼容性更好。
特点：

• 支持 .xlsx 格式（不支持旧版 .xls）；
• 跨平台（Windows、Linux、macOS），无需安装 Excel；
• 提供丰富的 API：单元格读写、合并单元格、字体 / 颜色 / 对齐方式设置、图表、批注等；
• 轻量，可直接将源码集成到项目（无需预编译库）。
  优缺点：
• 优点：跨平台性强、无外部依赖、集成简单、功能满足大多数场景；
• 缺点：不支持 .xls 格式，复杂图表或高级 Excel 功能（如宏、公式计算）支持有限。
• 适用场景：跨平台项目、无需依赖 Excel 环境、需要基本 Excel 读写和格式控制的场景（如数据导出、简单报表生成）。

2. QAxObject（Qt 自带，非纯开源库）

简介 ：QAxObject 是 Qt 提供的 ActiveX 组件交互类，通过调用 Windows 系统中的 Excel COM 接口操作 Excel 文件。它本身是 Qt 的一部分，无需额外下载，但依赖 Windows 系统和本地安装的 Excel。
特点：

• 支持 .xls 和 .xlsx 格式，可调用 Excel 的全部功能（包括宏、公式计算、高级图表等）；
• 本质是 "操控本地 Excel 程序"，操作方式与 VBA 类似。
  优缺点：
• 优点：功能完整（Excel 能做的它都能做），无需额外学习新 API（可参考 VBA 语法）；
• 缺点：仅支持 Windows 平台，必须安装 Excel，操作速度较慢（依赖 Excel 进程），跨平台项目无法使用。
  适用场景：仅限 Windows 平台、需要使用 Excel 高级功能（如宏、复杂公式）、允许依赖本地 Excel 安装的场景。

3. LibXL（半开源，免费版有限制）

简介 ：LibXL 是一个跨平台的 Excel 操作库（C/C++），提供 Qt 绑定，支持 .xls 和 .xlsx 格式。它分为免费版和商业版，免费版有功能限制（如无法隐藏水印、最多处理 100 行数据）。
特点：

• 跨平台（Windows、Linux、macOS），无需依赖 Excel；
• 支持丰富的格式控制（字体、颜色、边框、合并单元格等），支持公式计算和图表；
• 性能较好，比 QXlsx 处理大数据时更快。
  优缺点：
• 优点：支持 .xls 和 .xlsx，性能强，功能丰富；
• 缺点：免费版有功能限制，商业使用需要购买授权（价格较高）。
• 适用场景：需要处理 .xls 格式、对性能要求高、可接受商业授权的项目。

4. ODBC 接口（通过 QSqlDatabase）

简介 ：ODBC（开放数据库连接）是一种通用数据库接口，可将 Excel 文件视为 "数据库"，通过 Qt 的 QSqlDatabase 进行读写（需配置 Excel ODBC 驱动）。
特点：

• 跨平台（需安装对应平台的 Excel ODBC 驱动）；
• 操作方式类似数据库（通过 SQL 语句读写单元格数据）。
  优缺点：
• 优点：无需依赖 Excel，可跨平台，适合简单数据读写；
• 缺点：不支持格式控制（如字体、颜色），无法处理合并单元格、图表等，配置驱动较繁琐（尤其非 Windows 平台）。
• 适用场景：仅需简单读写 Excel 数据（无需格式）、可接受繁琐配置的跨平台项目。

总结与选择建议

库 / 方式	跨平台	依赖 Excel	支持格式	功能丰富度	开源 / 免费	推荐场景
QXlsx	是	否	.xlsx	中（够用）	完全开源（MIT）	跨平台、基本 Excel 操作
QAxObject	否（仅 Windows）	是	.xls/.xlsx	高（完整）	免费（Qt 自带）	Windows 平台、高级 Excel 功能
LibXL	是	否	.xls/.xlsx	高	免费版有限制	需.xls 格式、高性能、商业授权
ODBC	是（需驱动）	否	.xls/.xlsx	低（仅数据）	免费	简单数据读写、跨平台

二、QXlsx 库实际应用：从环境搭建到核心功能

通过上一部分的对比，不难发现 QXlsx 是 "跨平台、无依赖、功能均衡" 的最优解，也是大多数 Qt 项目的首选。本节将从环境搭建→基础操作→进阶功能→实战案例，完整覆盖 QXlsx 的使用流程。

2.1 QXlsx 环境搭建：两种集成方式（源码 / 静态库）

QXlsx 的集成方式灵活，推荐新手使用 "源码直接集成"（无需编译库，开箱即用），大型项目可选择 "编译静态库"（减少编译时间，便于多项目复用）。

方式 1：源码直接集成（推荐新手）

• 步骤 1：获取 QXlsx 源码
  GitHub 地址：https://github.com/QtExcel/QXlsx
  解压后，核心源码在QXlsx/src目录下（包含 20 多个.cpp 和.h 文件，如xlsxworkbook.h、xlsxworksheet.cpp）。
• 步骤 2：项目结构规划
  建议将 QXlsx 源码放在项目的 "第三方库" 目录下，保持项目结构清晰。如下：
  - 步骤 3：配置.pro 文件
  在项目的.pro文件中，添加 QXlsx 的头文件路径和源码文件，确保编译器能找到并编译 QXlsx 代码。
  Qt 5/.pro 配置示例：

#excel制作库
include($$PWD/QXlsx/QXlsx.pri)

然后工程中就有了QXlsx的文件结构：

• 步骤 4：验证集成是否成功
  在main.cpp中引入 QXlsx 头文件，编译项目。若无 "头文件找不到""未定义符号" 错误，说明集成成功：

#include <QApplication>
#include "thirdparty/qxlsx/src/xlsxworkbook.h"  // 引入QXlsx头文件

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    // 尝试创建工作簿，验证集成
    QXlsx::Workbook workbook;
    qDebug() << "QXlsx集成成功！";

    return a.exec();
}

方式 2：编译静态库（适合多项目复用）

若多个项目需使用 QXlsx，直接集成源码会导致重复编译，可将 QXlsx 编译为静态库（.a/.lib），供所有项目链接使用。

• 步骤 1：创建 QXlsx 静态库项目
  打开 Qt Creator，新建 "Library"→"C++ Library" 项目，类型选择 "Static Library"；
  项目名称设为 "QXlsxLib"，保存路径自定义；
  将 QXlsx 源码的src目录复制到项目根目录，删除默认生成的qxlsxlibrary.cpp和qxlsxlibrary.h。
• 步骤 2：配置静态库项目的.pro

QT += core widgets
TARGET = QXlsxLib  # 静态库名称
TEMPLATE = lib
CONFIG += staticlib  # 指定为静态库

# 头文件路径
INCLUDEPATH += $$PWD/src

# 添加所有QXlsx源码（同方式1的SOURCES和HEADERS）
SOURCES += \
    $$PWD/src/xlsxabstractooxmlfile.cpp \
    ...（省略其他.cpp文件，同方式1）

HEADERS += \
    $$PWD/src/xlsxabstractooxmlfile.h \
    ...（省略其他.h文件，同方式1）

# Qt 6专属配置
DEFINES += QXLSX_QT6

• 步骤 3：编译静态库
  选择对应的编译器（如 MinGW 64-bit、MSVC 2019），点击 "构建"，生成静态库文件：
  Windows（MinGW）：生成libQXlsxLib.a；
  Windows（MSVC）：生成QXlsxLib.lib；
  Linux：生成libQXlsxLib.a；
  macOS：生成libQXlsxLib.a。
• 步骤 4：在目标项目中链接静态库
  在需要使用 QXlsx 的项目的.pro中，添加静态库的路径和链接配置：

QT += core widgets

# 1. 头文件路径（指向QXlsx的src目录）
INCLUDEPATH += $$PWD/../QXlsxLib/src  # 需根据实际路径调整

# 2. 静态库路径（指向生成的.a/.lib文件所在目录）
LIBS += -L$$PWD/../QXlsxLib/build-QXlsxLib-Desktop_Qt_5_15_2_MinGW_64_bit-Debug/lib \
        -lQXlsxLib  # 链接静态库（MinGW用-lxxx，MSVC直接写xxx.lib）

# Qt 6专属配置
DEFINES += QXLSX_QT6

2.2 QXlsx 核心概念：3 个关键类

QXlsx 的 API 设计遵循 "Excel 对象模型"，核心逻辑围绕 3 个类展开，理解它们的关系是使用 QXlsx 的基础：

类名	对应 Excel 概念	核心作用
QXlsx::Workbook	工作簿	代表整个 Excel 文件，负责创建 / 加载 / 保存文件
QXlsx::Worksheet	工作表	代表 Excel 中的一个工作表，负责单元格操作
QXlsx::Format	单元格格式	定义单元格的样式（字体、颜色、对齐等）

2.3 QXlsx 基础操作：从创建到保存

接下来介绍 Excel 最常用的基础功能：创建工作簿、新建工作表、写入 / 读取单元格数据、格式设置、合并单元格、列宽行高调整，所有代码均附带详细注释。

• 示例 1：创建 Excel 文件并写入基础数据
  目标：创建一个包含 "学生成绩表" 的 Excel 文件，包含标题行和 2 条数据，设置标题格式，调整列宽。

#include <QApplication>
#include <QDebug>
#include "thirdparty/qxlsx/src/xlsxworkbook.h"
#include "thirdparty/qxlsx/src/xlsxworksheet.h"
#include "thirdparty/qxlsx/src/xlsxformat.h"

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    // 1. 创建工作簿（Workbook）：代表整个Excel文件
    QXlsx::Workbook workbook;

    // 2. 新建工作表（Worksheet）：默认工作表名为"Sheet1"，可自定义
    QXlsx::Worksheet *sheet = workbook.addSheet("学生成绩表");  // 新建名为"学生成绩表"的工作表
    // 若需获取默认工作表，可使用：QXlsx::Worksheet *sheet = workbook.activeSheet();

    // 3. 创建格式（Format）：定义标题单元格的样式
    QXlsx::Format titleFormat;
    titleFormat.setFontBold(true);                          // 字体加粗
    titleFormat.setFontSize(14);                            // 字体大小14号
    titleFormat.setHorizontalAlignment(QXlsx::Format::AlignHCenter);  // 水平居中
    titleFormat.setVerticalAlignment(QXlsx::Format::AlignVCenter);    // 垂直居中
    titleFormat.setFillColor(QColor(230, 240, 255));         // 背景色（淡蓝色）
    titleFormat.setBorderStyle(QXlsx::Format::BorderThin);   // 边框：细线条
    titleFormat.setBorderColor(QColor(100, 100, 100));       // 边框颜色（深灰色）

    // 4. 创建数据格式：定义数据单元格的样式
    QXlsx::Format dataFormat;
    dataFormat.setFontSize(12);                             // 字体大小12号
    dataFormat.setHorizontalAlignment(QXlsx::Format::AlignHCenter);  // 水平居中
    dataFormat.setBorderStyle(QXlsx::Format::BorderThin);   // 边框
    dataFormat.setBorderColor(QColor(100, 100, 100));       // 边框颜色

    // 5. 写入单元格数据：支持"单元格坐标"（如"A1"）或"行号+列号"（行/列从1开始）
    // 写入标题行（应用标题格式）
    sheet->write("A1", "学号", titleFormat);  // A1单元格：学号
    sheet->write("B1", "姓名", titleFormat);  // B1单元格：姓名
    sheet->write("C1", "数学", titleFormat);  // C1单元格：数学
    sheet->write("D1", "英语", titleFormat);  // D1单元格：英语
    sheet->write("E1", "总分", titleFormat);  // E1单元格：总分

    // 写入数据行（应用数据格式）
    sheet->write(2, 1, "2023001", dataFormat);  // 第2行第1列（A2）：学号
    sheet->write(2, 2, "张三", dataFormat);     // 第2行第2列（B2）：姓名
    sheet->write(2, 3, 95, dataFormat);        // 第2行第3列（C2）：数学成绩
    sheet->write(2, 4, 88, dataFormat);        // 第2行第4列（D2）：英语成绩
    sheet->write(2, 5, "=C2+D2", dataFormat);  // 第2行第5列（E2）：总分（公式）

    sheet->write(3, 1, "2023002", dataFormat);  // A3：学号
    sheet->write(3, 2, "李四", dataFormat);     // B3：姓名
    sheet->write(3, 3, 78, dataFormat);        // C3：数学成绩
    sheet->write(3, 4, 92, dataFormat);        // D3：英语成绩
    sheet->write(3, 5, "=C3+D3", dataFormat);  // E3：总分（公式）

    // 6. 调整列宽和行高
    sheet->setColumnWidth(1, 12);  // 第1列（A列）宽度12
    sheet->setColumnWidth(2, 10);  // 第2列（B列）宽度10
    sheet->setColumnWidth(3, 8);   // 第3列（C列）宽度8
    sheet->setColumnWidth(4, 8);   // 第4列（D列）宽度8
    sheet->setColumnWidth(5, 8);   // 第5列（E列）宽度8
    sheet->setRowHeight(1, 25);    // 第1行（标题行）高度25

    // 7. 保存Excel文件
    // 保存路径：默认在项目的构建目录下（如build-MyExcelProject-.../debug）
    QString savePath = QCoreApplication::applicationDirPath() + "/学生成绩表.xlsx";
    bool saveSuccess = workbook.saveAs(savePath);

    if (saveSuccess) {
        qDebug() << "Excel文件保存成功！路径：" << savePath;
    } else {
        qDebug() << "Excel文件保存失败！请检查路径权限。";
    }

    return a.exec();
}

运行结果：生成的 Excel 文件中，标题行呈淡蓝色、粗体居中，数据行带边框，总分列自动计算结果，列宽行高适配内容，整体样式整洁。

• 示例 2：读取已有的 Excel 文件数据
  目标：读取上一步生成的 "学生成绩表.xlsx"，提取所有数据并打印到控制台。

#include <QApplication>
#include <QDebug>
#include "thirdparty/qxlsx/src/xlsxworkbook.h"
#include "thirdparty/qxlsx/src/xlsxworksheet.h"

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    // 1. 定义Excel文件路径（需与保存路径一致）
    QString filePath = QCoreApplication::applicationDirPath() + "/学生成绩表.xlsx";

    // 2. 创建工作簿并加载文件
    QXlsx::Workbook workbook;
    bool loadSuccess = workbook.load(filePath);
    if (!loadSuccess) {
        qDebug() << "Excel文件加载失败！请检查路径是否正确。";
        return -1;
    }

    // 3. 获取目标工作表（通过工作表名称）
    QXlsx::Worksheet *sheet = workbook.sheet("学生成绩表");
    if (!sheet) {
        qDebug() << "未找到名为"学生成绩表"的工作表！";
        return -1;
    }

    // 4. 获取数据范围：确定表格的行数和列数（避免遍历空单元格）
    // 方法：获取最后一个非空行和最后一个非空列
    int lastRow = sheet->dimension().lastRow();    // 最后一行（示例中为3）
    int lastCol = sheet->dimension().lastColumn();// 最后一列（示例中为5）
    qDebug() << "数据范围：" << lastRow << "行，" << lastCol << "列";

    // 5. 遍历所有单元格，读取数据
    qDebug() << "\n读取到的Excel数据：";
    for (int row = 1; row <= lastRow; ++row) {  // 行从1开始
        QString rowData;
        for (int col = 1; col <= lastCol; ++col) {  // 列从1开始
            // 读取单元格数据（返回QVariant，需根据实际类型转换）
            QVariant cellValue = sheet->read(row, col);
            // 将数据拼接为字符串（处理数字、文本、公式结果）
            if (cellValue.isValid()) {
                rowData += cellValue.toString() + "\t";
            } else {
                rowData += "空\t";
            }
        }
        qDebug() << rowData;
    }

    return a.exec();
}

2.4 QXlsx 常见问题与解决方案

在实际开发中，使用 QXlsx 可能遇到编译错误、中文乱码、大数据处理缓慢等问题，以下是高频问题的解决方案：

（1）编译错误："找不到 xlsxworkbook.h" 或 "未定义符号"

问题原因：

• 头文件路径配置错误，编译器无法定位 QXlsx 源码；
• .pro文件中遗漏部分.cpp文件，导致链接时缺少符号。

解决方案：

• 检查INCLUDEPATH：确保路径指向 QXlsx 的src目录，且路径格式正确（Qt 中用"$$PWD"表示项目根目录，如$$PWD/thirdparty/qxlsx/src）；
• 核对SOURCES列表：打开src目录，确认所有.cpp文件均已添加到.pro的SOURCES中（可按文件名排序逐一核对，避免遗漏xlsxchart_p.cpp等隐藏后缀文件）；
• 清理项目后重新编译：Qt Creator 中点击「项目」→「清理项目」，再点击「构建」，避免旧编译缓存干扰。

（2）中文乱码：Excel 中中文显示为 "???"

问题原因：

QXlsx 默认使用 UTF-8 编码，但 Excel 打开文件时可能默认使用 GBK 编码，导致编码不匹配；

字符串未指定编码格式，Qt 中默认字符串为 UTF-16，写入 Excel 时未正确转换。
解决方案：

• 确保字符串编码统一：在写入中文前，将字符串转换为 UTF-8 格式（如QString("员工信息").toUtf8()）；
• 强制 Excel 使用 UTF-8 编码：在保存文件前，添加编码设置（需修改 QXlsx 源码）：
• 打开src/xlsxsharedstrings.cpp，找到write()函数，在xmlWriter.writeStartElement("sst")后添加：

xmlWriter.writeAttribute("xml:lang", "zh-CN");
xmlWriter.writeAttribute("encoding", "UTF-8");

• 用 WPS 打开验证：若 Microsoft Excel 仍乱码，尝试用 WPS 打开（WPS 对 UTF-8 兼容性更好），或在 Excel 中手动设置编码（「数据」→「获取外部数据」→「从文本 / CSV」→选择 UTF-8）。

（3）大数据处理：10 万行数据写入后内存溢出或卡顿

问题原因：

QXlsx 默认将所有单元格数据存入内存，大数据量时占用内存过高（10 万行 ×10 列约占用 100MB + 内存）；

一次性写入所有数据，未分块处理，导致主线程阻塞。
解决方案：

• 分块写入数据：每写入 1000 行数据，调用QCoreApplication::processEvents()释放主线程，避免卡顿：

for (int i = 0; i < 100000; ++i) {
    sheet->write(i+3, 1, QString("员工%1").arg(i));
    sheet->write(i+3, 2, "技术部");
    // ... 其他列数据 ...

    // 每1000行释放一次事件循环
    if (i % 1000 == 0) {
        QCoreApplication::processEvents();
    }
}

• 禁用不必要的格式：大数据场景下，减少Format对象创建（如复用同一个dataFormat，而非每行创建新对象），格式越简单，写入速度越快；
• 使用QXlsx::Worksheet::writeArray()批量写入：对于二维数组数据，优先使用writeArray()（底层优化了 IO 操作），比循环write()快：

// 示例：批量写入1000行2列数据
QVector<QVector<QVariant>> data(1000, QVector<QVariant>(2));
for (int i = 0; i < 1000; ++i) {
    data[i][0] = QString("员工%1").arg(i);
    data[i][1] = 20000 + qRand() % 10000;
}
sheet->writeArray("A3", data, dataFormat);  // 从A3开始写入二维数组

（4）保存失败："saveAs () 返回 false"

问题原因：

• 保存路径不存在（如指定 "C:\ 未创建的文件夹 \test.xlsx"）；
• 文件被占用（如 Excel 已打开该文件，导致写入权限不足）；
• 磁盘空间不足或权限不够（如 Linux 下无写入当前目录的权限）。
  解决方案：
• 检查路径合法性：用QDir确保保存目录存在，不存在则创建：

QString saveDir = QCoreApplication::applicationDirPath() + "/reports";
QDir dir(saveDir);
if (!dir.exists()) {
    dir.mkpath(saveDir);  // 创建目录（包括父目录）
}
QString savePath = saveDir + "/员工信息报表.xlsx";

• 释放文件占用：提示用户关闭已打开的 Excel 文件，或在保存前检查文件是否被占用：

QFile file(savePath);
if (file.isOpen()) {
    file.close();
}
if (file.exists() && !file.remove()) {  // 若文件已存在，尝试删除旧文件
    qDebug() << "旧文件被占用，无法覆盖！";
    return false;
}

• 检查权限：Linux/macOS 下，用dir.permissions()检查目录是否有写入权限，必要时用sudo运行程序测试。

2.7 QXlsx 扩展使用技巧

除了基础和进阶功能，QXlsx 还可通过一些技巧满足更复杂的需求，提升开发效率：

（1）批量处理：读取 Excel 文件并导入数据库

在实际项目中，常需将 Excel 中的数据导入到 MySQL、SQLite 等数据库，可结合 Qt 的QSqlDatabase实现：

// 示例：读取Excel数据并插入SQLite数据库
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>

bool importExcelToDb(const QString &excelPath, const QString &dbPath) {
    // 1. 加载Excel文件
    QXlsx::Workbook workbook;
    if (!workbook.load(excelPath)) {
        qDebug() << "Excel加载失败！";
        return false;
    }
    QXlsx::Worksheet *sheet = workbook.sheet("员工信息表");
    if (!sheet) return false;

    // 2. 连接SQLite数据库
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName(dbPath);
    if (!db.open()) {
        qDebug() << "数据库连接失败：" << db.lastError().text();
        return false;
    }

    // 3. 创建表（若不存在）
    QSqlQuery query;
    QString createTableSql = "CREATE TABLE IF NOT EXISTS employee ("
                            "id INTEGER PRIMARY KEY AUTOINCREMENT,"
                            "name TEXT,"
                            "dept TEXT,"
                            "job TEXT,"
                            "salary REAL)";
    if (!query.exec(createTableSql)) {
        qDebug() << "创建表失败：" << query.lastError().text();
        return false;
    }

    // 4. 读取Excel数据并插入数据库
    int lastRow = sheet->dimension().lastRow();
    for (int row = 3; row <= lastRow; ++row) {  // 从第3行（数据行）开始
        QString name = sheet->read(row, 1).toString();
        QString dept = sheet->read(row, 2).toString();
        QString job = sheet->read(row, 3).toString();
        double salary = sheet->read(row, 4).toDouble();

        // 插入SQL
        QString insertSql = QString("INSERT INTO employee (name, dept, job, salary) "
                                    "VALUES ('%1', '%2', '%3', %4)")
                            .arg(name).arg(dept).arg(job).arg(salary);
        if (!query.exec(insertSql)) {
            qDebug() << "插入数据失败（行" << row << "）：" << query.lastError().text();
            continue;
        }
    }

    db.close();
    qDebug() << "Excel数据导入数据库成功！共" << (lastRow-2) << "条数据。";
    return true;
}

（2）模板导出：基于固定模板填充数据

若需生成格式固定的报表（如公司财务模板、项目验收模板），可先在 Excel 中创建模板文件（含 logo、固定表头、签名区），再用 QXlsx 填充动态数据，避免重复设置格式：

// 示例：基于模板填充数据
bool fillExcelTemplate(const QString &templatePath, const QString &outputPath, const QList<Employee> &empList) {
    // 1. 加载模板文件（模板中已设置好标题、表头、logo）
    QXlsx::Workbook workbook;
    if (!workbook.load(templatePath)) {
        qDebug() << "模板加载失败！";
        return false;
    }
    QXlsx::Worksheet *sheet = workbook.activeSheet();
    if (!sheet) return false;

    // 2. 填充动态数据（假设模板中数据从第5行开始）
    int startRow = 5;
    for (int i = 0; i < empList.size(); ++i) {
        int row = startRow + i;
        const auto &emp = empList[i];
        sheet->write(row, 1, emp.name);    // 模板中A列是姓名
        sheet->write(row, 2, emp.dept);    // B列是部门
        sheet->write(row, 3, emp.salary);  // C列是薪资（模板已设置数值格式）
    }

    // 3. 填充统计信息（模板中D10单元格是"总人数"，D11是"平均薪资"）
    int totalCount = empList.size();
    double totalSalary = 0;
    for (const auto &emp : empList) totalSalary += emp.salary;
    double avgSalary = totalCount > 0 ? totalSalary / totalCount : 0;

    sheet->write("D10", totalCount);
    sheet->write("D11", avgSalary);

    // 4. 保存填充后的文件
    return workbook.saveAs(outputPath);
}

优势：

• 格式维护方便：模板由 Excel 直接编辑，无需在代码中重复设置格式；
• 降低开发成本：代码只需关注数据填充，无需关注样式细节。

（3）加密保存：保护 Excel 文件不被篡改

QXlsx 本身不直接支持 Excel 文件加密，但可通过 Qt 的QCryptographicHash结合文件加密工具（如 OpenSSL）实现简单加密，或生成加密压缩包：

// 示例：生成加密压缩包（需链接Qt的network模块，或使用第三方压缩库）
#include <QZipWriter>
#include <QCryptographicHash>

bool encryptExcel(const QString &excelPath, const QString &zipPath, const QString &password) {
    // 1. 读取Excel文件内容
    QFile excelFile(excelPath);
    if (!excelFile.open(QIODevice::ReadOnly)) return false;
    QByteArray excelData = excelFile.readAll();
    excelFile.close();

    // 2. 简单加密（基于密码生成密钥，异或加密，适合轻量级保护）
    QByteArray key = QCryptographicHash::hash(password.toUtf8(), QCryptographicHash::Sha256).left(16);
    QByteArray encryptedData;
    for (int i = 0; i < excelData.size(); ++i) {
        encryptedData.append(excelData[i] ^ key[i % key.size()]);
    }

    // 3. 写入加密压缩包
    QZipWriter zipWriter(zipPath);
    QZipWriter::FileInfo fileInfo;
    fileInfo.setFileName("员工信息报表_encrypted.xlsx");
    zipWriter.addFile(fileInfo, encryptedData);
    zipWriter.close();

    return true;
}

注意：

• 轻量级加密适合普通场景，若需高强度加密，建议集成 OpenSSL 库（如使用EVP_EncryptInit_ex等函数）；
• 解密时需对应解密逻辑，确保用户能正确解析文件。

三、总结

QXlsx 的核心优势与适用场景
核心优势

• 跨平台无依赖：一次编码可在 Windows、Linux、macOS 运行，无需用户安装 Excel，降低部署门槛；
• 轻量级易集成：源码仅 20 + 文件，可直接集成到项目，无需预编译库，编译配置简单；
• 功能均衡：支持单元格读写、格式控制、图表、公式，满足报表生成、数据导出等常规需求；
• 开源免费：MIT 协议允许商业项目免费使用，无版权风险，社区维护活跃（GitHub 星标 5k+，issues 响应及时）。

适用场景

• 跨平台桌面应用（如工业控制软件、跨平台管理系统）；
• 轻量级数据导出 / 导入（如工具类软件、小型报表系统）；
• 无 Excel 依赖的场景（如嵌入式设备、服务器端数据生成）；
• 需基础格式控制（如字体、颜色、图表）的报表需求。