当前位置：首页 > 文章列表 > Golang > Go教程 > Golang读写Excel教程：excelize使用指南

Golang读写Excel教程：excelize使用指南

2025-08-04 19:03:30 0浏览收藏

本文是一篇关于**Golang操作Excel**的实用教程，重点讲解如何使用强大的`excelize/v2`库进行Excel文件的读写操作。文章从创建或打开Excel文件入手，详细介绍了如何使用`NewFile()`和`OpenFile()`函数，并深入讲解了如何利用`SetCellValue`方法向指定单元格写入数据。此外，教程还涵盖了使用`GetCellValue`方法读取数据，以及通过`Rows`接口遍历整行数据的方法。更进一步，文章还介绍了如何使用`NewStyle`定义样式，并通过`SetCellStyle`应用样式，以及使用`SetColWidth`调整列宽等高级技巧。无论你是需要导入用户信息、订单列表，还是仅仅需要美化你的Excel表格，本文都能为你提供清晰、实用的指导，助你轻松掌握**Golang 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库读写电子表格

用 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)

还可以设置自动列宽：