Golang读写Excel：Excelize教程详解

本文是一篇关于如何在 Golang 中使用 Excelize 库进行 Excel 文件读写操作的教程。Excelize 是一个功能强大的 Go 语言库，它允许开发者轻松地创建、读取、修改和保存 Excel 文件。本文将介绍如何使用 Excelize 创建或打开 Excel 文件，写入数据到指定单元格，读取单元格中的数据，以及设置单元格的样式和格式。通过学习本文，你将能够掌握使用 Golang 操作 Excel 文件的基本技巧，并能利用 Excelize 轻松实现诸如数据导入导出、报表生成等功能。无论你是需要处理大量数据的后端工程师，还是希望为你的 Go 应用添加 Excel 功能，本文都将为你提供有价值的指导。

使用 Golang 操作 Excel 文件可通过 excelize/v2 库实现，1. 创建或打开文件：f := excelize.NewFile() 或 f, err := excelize.OpenFile("example.xlsx")；2. 写入数据：用 SetCellValue 方法指定 sheet 名、单元格和值，如 f.SetCellValue("Sheet1", "A1", "姓名")；3. 读取数据：通过 GetCellValue 获取单个值，或结合 Rows 遍历整行数据；4. 设置样式：调用 NewStyle 定义样式并用 SetCellStyle 应用；5. 调整格式：如 SetColWidth 设置列宽。操作完成后需调用 SaveAs 或 WriteTo 保存文件。

用 Golang 操作 Excel 文件其实挺方便的，尤其借助像 excelize/v2 这样的第三方库，可以很轻松地实现读写、样式设置、图表插入等功能。如果你之前是用 Python 处理 Excel 的，那用 Go 来操作也差不多，只是语法和接口略有不同。

下面我会从几个常用的场景出发，讲讲怎么用 excelize 来处理 Excel 文件。

创建与打开 Excel 文件

使用 excelize 最基本的操作就是创建一个新文件或者打开已有的文件。

• 创建新文件很简单：

f := excelize.NewFile()

• 打开已有文件需要调用 OpenFile：

f, err := excelize.OpenFile("example.xlsx")
if err != nil {
    log.Fatal(err)
}

不管是新建还是打开，后续的操作都围绕这个 f *excelize.File 对象展开。

注意：如果要保存文件，记得调用 f.SaveAs("output.xlsx") 或者 f.WriteTo() 方法输出。

写入数据到单元格

写入数据主要用的是 SetCellValue 方法，指定工作表名、单元格坐标和值。

比如：

f.SetCellValue("Sheet1", "A1", "姓名")
f.SetCellValue("Sheet1", "B1", "年龄")

你也可以批量写入，比如遍历一个结构体数组，把每条记录写入对应行。

一个小技巧是：可以用 fmt.Sprintf("A%d", row) 构造单元格地址，这样在循环中就能动态定位位置。

常见问题：

• 工作表名字不对导致写入失败
• 单元格地址格式错误（比如列号超过 Z）

读取 Excel 中的数据

读取也是通过 GetCellValue 方法，传入 sheet 名和单元格地址：

val, _ := f.GetCellValue("Sheet1", "A1")
fmt.Println(val)

如果是读取整列或整行，建议结合 Rows 或 Cols 接口来处理。

比如读取某一行的所有值：

rows, _ := f.Rows("Sheet1")
for rows.Next() {
    rowCells, _ := rows.Columns()
    fmt.Println(rowCells)
}

这种方式适合处理结构化数据，比如导入用户信息、订单列表等。

设置样式和调整格式（进阶）

除了内容，样式也很重要。你可以设置字体、背景颜色、边框、对齐方式等等。

以设置字体为例：

style, _ := f.NewStyle(&excelize.Style{
    Font: &excelize.Font{
        Bold:   true,
        Italic: true,
        Color:  "#FF0000",
    },
})
f.SetCellStyle("Sheet1", "A1", "A1", style)

还可以设置自动列宽：

f.SetColWidth("Sheet1", "A", "C", 20)

这些操作虽然稍微复杂点，但能让导出的表格更美观、专业。

基本上就这些。用 excelize 做 Excel 操作不难，关键是熟悉常用方法和参数。刚开始可能会遇到一些类型转换或格式问题，多查文档、看例子很快就能上手。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang读写Excel：Excelize教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。