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

一、概述

在 c++ 开发场景中，程序化生成与写入 excel 文档是企业级应用常见需求，涵盖报表导出、数据归档、自动化报告生成等领域。相较于依赖 microsoft 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> 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() 方法写入文本：

// 定位到第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> 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 中的数据一次性写入指定单元格范围。

基本用法如下：

// 准备二维数据数组
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 异常或操作异常。