## 一、概述

在 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. **索引约定**：行号和列号均从 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 报表成为一项高效且可控的任务。

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

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

编程语言

C++开发中使用Spire.XLS库实现Excel文档生成，涵盖单单元格写入、批量数据填充和样式格式化。无需安装Office环境，通过Workbook、Worksheet和CellRange对象高效创建报表，支持文本、数值、日期等多种数据类型写入，提升企业级应用开发效率。

数据归档

内存管理

代码解释

腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

通过 C++ 写入数据到 Excel 文档-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐