通过C++写入数据到Excel文档的方法示例

一、概述

在 C++ 开发里，程序化生成和写入 Excel 文档，几乎是企业级应用的标配需求。报表导出、数据归档、自动化报告生成……这些场景，如果你还在依赖 Microsoft Office 自动化组件，那可真要掂量一下了。部署麻烦、性能不稳定、还得装 Office 环境，光是想想就头大。相比之下，专用 Excel 处理库就清爽多了——独立部署、性能稳定，而且完全不需要 Office 的支持。

这篇文章，我们就以 Spire.XLS for C++ 库为例，从环境集成到各种数据写入，系统地把整个技术实现讲透。单单元格写入、批量数据填充、样式格式化……这些核心场景，一个都不会落下。

二、环境配置

2.1 库的获取与集成

引入 Spire.XLS for C++ 很简单：在项目里右键引用 → 管理 NuGet 程序包，搜索 Spire.XLS.Cpp 并安装即可。

2.2 头文件引用

使用的时候，记得在源文件中包含主头文件：

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

三、核心对象模型

Spire.XLS for C++ 的对象模型，其实和 Excel 文档的层次结构是一一对应的，理解起来并不复杂：

• Workbook：代表整个 Excel 工作簿，所有操作的顶层入口。
• Worksheet：工作簿里的单个工作表。
• CellRange：一个单元格或单元格区域，读写数据、设置样式全靠它。

创建新工作簿并获取工作表的典型代码，是这样写的：

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

四、向单元格写入数据

4.1 写入文本值

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

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

4.2 写入数值

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

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

4.3 写入日期时间

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

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

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

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

#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 = new Workbook();
    
    // 获取第一个工作表
    intrusive_ptr sheet = 
        dynamic_pointer_cast(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->Sa veToFile(outputFile.c_str(), ExcelVersion::Version2013);
    workbook->Dispose();
    
    return 0;
}

五、批量写入数据

如果数据量比较大，逐单元格写入的效率实在让人捉急。好在 Spire.XLS for C++ 提供了 Worksheet->InsertArray() 方法，可以把 std::vector 中的数据一次性写入指定单元格范围，效率提升不是一点半点。

具体用法如下：

// 准备二维数据数组
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 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. 索引约定：行号和列号均从 1 开始计数，和 Excel 界面保持一致，别搞混了。
2. 内存管理：Workbook 和 Worksheet 对象用完了，记得调用 Dispose() 释放资源，不然内存泄漏可不是闹着玩的。
3. 宽字符串：所有文本参数必须使用宽字符串类型（L"..." 或 std::wstring），因为库内部用的是 Unicode 编码。
4. 文件格式：保存时可以通过 ExcelVersion 枚举指定输出格式，像 Version97to2003（.xls）、Version2013（.xlsx）等多种版本都支持。
5. 异常处理：生产环境里，建议加上 try-catch 块，捕获可能出现的文件 I/O 异常或操作异常，避免程序崩溃。

七、小结

通过 Workbook、Worksheet 和 CellRange 这三个核心类，你基本上可以把从单个单元格写入到批量数据导入的操作都搞定。再加上基于向量的批量写入机制和丰富的样式设置能力，在 C++ 应用里生成专业格式的 Excel 报表，已经是一件相当高效且可控的事情了。