当前位置：首页 > article >正文

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

article 2025/7/3 15:11:56

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    stringKey      stringChildren []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")