Go语言实战：使用 excelize 实现多层复杂Excel表头导出教程

Go 实现支持多层复杂表头的 Excel 导出工具

目录

• 项目介绍
• 依赖说明
• 核心结构设计
• 如何支持多层表头
• 完整使用示例
• 总结与扩展

项目介绍

在实际业务系统中，Excel 文件导出是一项常见功能，尤其是报表类需求中常见的复杂多级表头，常规表格组件往往无法满足。

本文基于 Go 语言和 excelize 库，封装一个支持多层嵌套表头结构的导出工具，兼顾灵活性与可维护性。

依赖说明

import (
	"fmt"
	"io"
	"github.com/xuri/excelize/v2"
)

安装依赖：

go get github.com/xuri/excelize/v2

核心结构设计

我们封装了一个 ExcelExporter 结构体，用于管理工作簿、表头结构和数据行追加。

简单表头支持：

func (e *ExcelExporter) SetSimpleHeaders(headers []string)
func (e *ExcelExporter) AppendData(data []interface{})

复杂表头支持：

我们定义了递归结构体 Header：

type Header struct {
    Title    string
    Key      string
    Children []Header
}

支持任意嵌套层级，例如：

Header{
  Title: "基础信息",
  Key:   "basic",
  Children: []Header{
    {
      Title: "身份信息",
      Key:   "identity",
      Children: []Header{
        {
          Title: "姓名", Key: "name"
        }, {
          Title: "性别", Key: "gender"
        }, {
          Title: "年龄", Key: "age"
        },
      },
    },
    {
      Title: "联系方式",
      Key:   "contact",
      Children: []Header{
        {Title: "手机号", Key: "mobile"},
        {Title: "邮箱", Key: "email"},
      },
    },
  },
},

通过递归函数 generateHeaders 自动合并单元格并映射每个字段的列坐标。

如何支持多层表头

关键点包括：

• 使用递归方法生成合并单元格
• 用 keyToColumn 映射字段名和坐标位置
• 自动计算最大深度，确保每行 header 对齐
• 根据字段长度自动设置列宽
• 对每个单元格设置统一样式（边框、居中等）

每一级 Header 都可能包含子 Header，当 Children 非空时，会合并主标题横向区域，并将子标题写入下一行。

完整使用示例

exporter := NewExcelExporter()
_ = exporter.CreateSheet("统计报表")

headers := []Header{
  {
    Title: "基础信息",
    Key:   "basic",
    Children: []Header{
      {
        Title: "身份信息",
        Key:   "identity",
        Children: []Header{
          {Title: "姓名", Key: "name"},
          {Title: "性别", Key: "gender"},
        },
      },
      {
        Title: "联系方式",
        Key:   "contact",
        Children: []Header{
          {Title: "手机号", Key: "mobile"},
        },
      },
    },
  },
  {Title: "是否有孩子", Key: "has_child"},
}

_ = exporter.SetComplexHeaders(headers)

_ = exporter.AppendRow(map[string]interface{}{
  "name": "张三",
  "gender": "男",
  "mobile": "13800000000",
  "has_child": "是",
})

_ = exporter.SaveToFile("output.xlsx")

总结与扩展

总结

本文实现了一个具备如下能力的 Excel 工具：

• ✅ 简单和复杂表头共存支持
• ✅ 任意层级嵌套的结构导出
• ✅ 表头自动合并、样式统一
• ✅ 数据字段位置自动映射

可拓展方向

• 支持设置日期、货币等格式
• 支持按条件着色或高亮
• 支持单元格注释、批注
• 与后端服务结合，实现 API 下载
• 多 Sheet 支持、分页导出等

---

项目地址建议发布至 GitHub 并附带 Demo 示例，欢迎读者按需定制化封装，助力高效构建导出报表模块。