基于数据生成 excel 文档是一个很常见的需求,本文将介绍如何使用 go 的 excelize 库去生成 excel 文档,以及一些具体场景下的代码实现。

关于 excelize 库

excelize 是 go 语言编写的用于操作 office excel 文档基础库,基于 ecma-376,iso/iec 29500 国际标准。可以使用它来读取、写入由 microsoft excel™ 2007 及以上版本创建的电子表格文档。支持 xlsx / xlsm / xltm / xltx 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 api,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 go 语言为 1.15 或更高版本。

性能对比

下图是一些主要的开源 excel 库在生成 12800*50 纯文本矩阵时的性能对比(os: macos mojave version 10.14.4, cpu: 3.4 ghz intel core i5, ram: 16 gb 2400 mhz ddr4, hdd: 1 tb),包括 go、python、java、php 和 nodejs。

Golang生成Excel文档的方法步骤

安装

最新的版本是 v2.4.0:

go get github.com/360entsecgroup-skylar/excelize/v2

创建 excel 文档

下面的案例中,我们创建了一个 excel 文档,并使用 newsheet 方法新建了一个 sheet2 工作表,sheet1 是默认创建的工作表,然后我们使用 setcellvalue 方法分别在 sheet2 工作表的 a2 单元格 和 sheet1 表格的 b2 单元格设置值,并通过使用 setactivesheet 方法设置 sheet2 工作表为默认的工作表,最终调用 saveas 方法将数据写入 excel 文档中:

package mainimport(    "fmt"    "github.com/360entsecgroup-skylar/excelize/v2")func main() {    f := excelize.newfile()    // 创建一个工作表    index := f.newsheet("sheet2")    // 设置单元格的值    f.setcellvalue("sheet2", "a2", "hello world.")    f.setcellvalue("sheet1", "b2", 100)    // 设置工作簿的默认工作表    f.setactivesheet(index)    // 根据指定路径保存文件    iferr := f.saveas("book1.xlsx"); err != nil {        fmt.println(err)    }}

实际场景复现

创建工作表

工作表名称是大小写敏感的:

index := f.newsheet("sheet2")

删除默认创建的工作表

默认创建的 excel 文档是包含一个名为 sheet1 的工作表,我们可能并不需要这个默认工作表,这个时候我们可以删除这个工作表:

f.deletesheet("sheet1")

合并单元格

合并 sheet1 工作表上 f1:i2 区域内的单元格:

excel.mergecell("sheet1", "f1", "i2")

单元格样式

给单元格设置样式会经常遇到,比如设置单元格的背景颜色,excelize 库提供下面两个方法进行设置单元格样式(newstyle 和 setcellstyle):

// 通过给定的样式格式 json 或结构体的指针创建样式并返回样式索引。// 请注意,颜色需要使用 rgb 色域代码表示。style, err := f.newstyle(`{    "border": [    {        "type": "left",        "color": "0000ff",        "style": 3    },    {        "type": "top",        "color": "00ff00",        "style": 4    },    {        "type": "bottom",        "color": "ffff00",        "style": 5    },    {        "type": "right",        "color": "ff0000",        "style": 6    },    {        "type": "diagonaldown",        "color": "a020f0",        "style": 7    },    {        "type": "diagonalup",        "color": "a020f0",        "style": 8    }]}`)iferr != nil {    fmt.println(err)}err = f.setcellstyle("sheet1", "d7", "d7", style)

文字水平居中

文字水平居中需要用到 alignment 样式结构体:

type alignment struct {    horizontal      string `json:"horizontal"`    indent          int    `json:"indent"`    justifylastline bool   `json:"justify_last_line"`    readingorder    uint64 `json:"reading_order"`    relativeindent  int    `json:"relative_indent"`    shrinktofit     bool   `json:"shrink_to_fit"`    textrotation    int    `json:"text_rotation"`    vertical        string `json:"vertical"`    wraptext        bool   `json:"wrap_text"`}

水平居中只要设置 horizontal 的值为 center 即可:

style, err := f.newstyle(`{"alignment":{"horizontal":"center"}}`)iferr != nil {    fmt.println(err)}err = excel.setcellstyle("sheet1", "b1", "b1", style)

给单元格设置纯色填充

给单元格填充颜色会使用到 fill 样式结构体:

type fill struct {    type    string   `json:"type"`    pattern int      `json:"pattern"`    color   []string `json:"color"`    shading int      `json:"shading"`}

style 结构体

从上面设置样式的代码中,我们可以发现 border 是一个数组,而 alignment 是一个结构体,这是由 style 结构体决定的:

type style struct {    border        []border    `json:"border"`    fill          fill        `json:"fill"`    font          *font       `json:"font"`    alignment     *alignment  `json:"alignment"`    protection    *protection `json:"protection"`    numfmt        int         `json:"number_format"`    decimalplaces int         `json:"decimal_places"`    customnumfmt  *string     `json:"custom_number_format"`    lang          string      `json:"lang"`    negred        bool        `json:"negred"`}

参考文档

原文链接:https://juejin.cn/post/6971452271498526756