通过 C++ 写入数据到 Excel 文档

一、概述

在 C++ 开发场景中，程序化生成与写入 Excel 文档是企业级应用常见需求，涵盖报表导出、数据归档、自动化报告生成等领域。相较于依赖 Microsoft Office 自动化组件的方案，专用 Excel 处理库具备部署独立、性能稳定、无需安装 Office 环境等优势。

本文基于 Spire.XLS for C++ 库，系统讲解从环境集成到各类数据写入的完整技术实现，覆盖单单元格写入、批量数据填充、样式格式化等核心场景。

二、环境配置

2.1 库的获取与集成

Spire.XLS for C++ 可通过右键项目引用 → 管理 NuGet 程序包，搜索 Spire.XLS.Cpp 并安装。

2.2 头文件引用

使用该库时，需要在源文件中包含主头文件：

cpp 复制代码

#include "Spire.Xls.o.h"
using namespace Spire::Xls;

三、核心对象模型

Spire.XLS for C++ 的对象模型遵循 Excel 文档的层次结构：

Workbook：表示整个 Excel 工作簿，是操作的顶层入口
Worksheet：表示工作簿中的单个工作表
CellRange：表示一个单元格或单元格区域，用于读写数据和设置样式

创建新工作簿并获取工作表的典型代码如下：

cpp 复制代码

// 创建 Workbook 对象
intrusive_ptr<Workbook> workbook = new Workbook();
// 获取第一个工作表（索引从 0 开始）
intrusive_ptr<Worksheet> sheet = 
    dynamic_pointer_cast<Worksheet>(workbook->GetWorksheets()->Get(0));

四、向单元格写入数据

4.1 写入文本值

使用 Worksheet->GetRange(int row, int column) 方法定位到指定单元格（行号和列号均从 1 开始），然后调用 CellRange->SetText() 方法写入文本：

cpp 复制代码

// 定位到第1行第1列，写入文本
sheet->GetRange(1, 1)->SetText(L"姓名");
sheet->GetRange(1, 2)->SetText(L"年龄");
sheet->GetRange(1, 3)->SetText(L"部门");

4.2 写入数值

写入数值使用 CellRange->SetNumberValue() 方法：

cpp 复制代码

sheet->GetRange(2, 2)->SetNumberValue(29);
sheet->GetRange(3, 2)->SetNumberValue(27);

4.3 写入日期时间

对于日期时间类型的数据，可直接以文本形式写入并配合格式设置：

cpp 复制代码

sheet->GetRange(2, 4)->SetText(L"2021-02-26");
// 设置日期格式
sheet->GetRange(2, 4)->SetNumberFormat(L"yyyy-mm-dd");

4.4 完整示例：写入员工信息表

以下代码演示了如何创建一个包含员工信息（姓名、年龄、部门、入职日期）的表格：

cpp 复制代码

#include "Spire.Xls.o.h"
using namespace Spire::Xls;

int main() {
    // 指定输出文件路径
    std::wstring outputPath = L"Output\\";
    std::wstring outputFile = outputPath + L"EmployeeData.xlsx";
    
    // 创建 Workbook 对象
    intrusive_ptr<Workbook> workbook = new Workbook();
    
    // 获取第一个工作表
    intrusive_ptr<Worksheet> sheet = 
        dynamic_pointer_cast<Worksheet>(workbook->GetWorksheets()->Get(0));
    
    // 写入表头
    sheet->GetRange(1, 1)->SetText(L"姓名");
    sheet->GetRange(1, 2)->SetText(L"年龄");
    sheet->GetRange(1, 3)->SetText(L"部门");
    sheet->GetRange(1, 4)->SetText(L"入职日期");
    
    // 写入数据行
    sheet->GetRange(2, 1)->SetText(L"Hazel");
    sheet->GetRange(2, 2)->SetNumberValue(29);
    sheet->GetRange(2, 3)->SetText(L"Marketing");
    sheet->GetRange(2, 4)->SetText(L"2021-02-26");
    
    sheet->GetRange(3, 1)->SetText(L"Tina");
    sheet->GetRange(3, 2)->SetNumberValue(27);
    sheet->GetRange(3, 3)->SetText(L"Human Resource");
    sheet->GetRange(3, 4)->SetText(L"2020-07-13");
    
    sheet->GetRange(4, 1)->SetText(L"Amy");
    sheet->GetRange(4, 2)->SetNumberValue(35);
    sheet->GetRange(4, 3)->SetText(L"Development");
    sheet->GetRange(4, 4)->SetText(L"2019-04-01");
    
    // 保存工作簿
    workbook->SaveToFile(outputFile.c_str(), ExcelVersion::Version2013);
    workbook->Dispose();
    
    return 0;
}

五、批量写入数据

当需要批量写入大量数据时，逐单元格写入的效率较低。Spire.XLS for C++ 提供了 Worksheet->InsertArray() 方法，可将 std::vector 中的数据一次性写入指定单元格范围。

基本用法如下：

cpp 复制代码

// 准备二维数据数组
wstring twoDimensionalArray[4][3] = {
    { L"区域", L"Q1销售额", L"Q2销售额" },
    { L"华东", L"125000", L"138000" },
    { L"华北", L"98000", L"105000" },
    { L"华南", L"112000", L"120000" }
};

// 获取行数列数
int rowNum = sizeof(twoDimensionalArray) / sizeof(twoDimensionalArray[0]);
int columnNum = sizeof(twoDimensionalArray[0]) / sizeof(twoDimensionalArray[0][0]);

// 将二维数组拆分为多个一维向量
for (size_t i = 0; i < rowNum; i++)
{
	vector<LPCWSTR> vec_temp;
	for (size_t j = 0; j < columnNum; j++)
	{
		vec_temp.push_back(twoDimensionalArray[i][j].c_str());
	}

// 插入数组
sheet->InsertArray(vec_temp, 4 + i, 1, false);
}

六、注意事项

索引约定：行号和列号均从 1 开始计数，与 Excel 界面保持一致。
内存管理 ：Workbook 和 Worksheet 对象使用完毕后，应调用 Dispose() 方法释放资源。
宽字符串 ：所有文本参数需使用宽字符串类型（L"..." 或 std::wstring），因为库内部使用 Unicode 编码。
文件格式 ：保存时可通过 ExcelVersion 枚举指定输出格式，支持 Version97to2003（.xls）、Version2013（.xlsx）等多种版本。
异常处理：建议在实际生产代码中添加 try-catch 块，捕获可能发生的文件 I/O 异常或操作异常。

七、小结

通过 Workbook、Worksheet 和 CellRange 三个核心类，开发者可以实现从单个单元格写入到批量数据导入操作。其基于向量的批量写入机制和丰富的样式设置能力，使得在 C++ 应用中生成专业格式的 Excel 报表成为一项高效且可控的任务。