一、概述

在 C++ 项目开发中，程序化生成与写入 Excel 文档已成为企业级应用的常见需求。无论是报表导出、数据归档，还是自动化报告生成，若仍依赖 Microsoft Office 自动化组件，则需面对部署繁琐、性能不稳、强制 Office 环境等痛点。相比之下，专用 Excel 处理库具备独立部署、性能稳定、无需 Office 支持等优势，成为更优选择。

本文以 Spire.XLS for C++ 库为例，系统讲解从环境集成到多种数据写入的完整技术实现。涵盖单单元格写入、批量数据填充、样式格式化等核心场景，帮助开发者高效掌握 C++ 操作 Excel 的关键方法。

二、环境配置

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 报表，已成为高效且可控的解决方案。