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

Golang读写Excel：excelize使用教程详解

2025-09-21 19:20:32 0浏览收藏

还在为Golang操作Excel表格而烦恼吗？本文将深入讲解如何使用强大的excelize库，轻松实现Excel文件的读写及高级操作。作为Go语言处理Excel的优选方案，excelize凭借其直观的API，让你可以快速上手，无论是新建或打开文件，进行单元格读写、合并单元格、设置列宽等基础操作，还是处理大型文件，优化内存占用，都能得心应手。此外，excelize还支持图表、图片、公式、条件格式、数据验证等高级特性，助你轻松生成复杂的专业报表。还在等什么？快来学习如何利用excelize，让你的Golang项目在Excel处理方面如虎添翼！

答案：使用excelize库可高效实现Golang对Excel文件的读写及高级操作。该库提供直观API，支持新建或打开文件、单元格读写、合并单元格、设置列宽等基础功能；通过流式读写优化大型文件处理，降低内存占用；并支持图表、图片、公式、条件格式、数据验证等高级特性，适用于复杂报表生成，具备跨平台、高性能、社区活跃等优势，是Go语言处理Excel的优选方案。

怎样用Golang操作Excel文件通过excelize库读写电子表格

用Golang操作Excel文件，特别是借助excelize库，这事儿真没想象中那么复杂。它提供了一套非常直观的API，让你能轻松地读写电子表格，无论是简单的数据录入还是复杂的文件解析，都能找到对应的解决方案。可以说，excelize是Go语言生态里处理Excel文件的一个非常趁手的工具。

解决方案

要用excelize库来读写Excel文件，我们首先得把它引入到项目里。这通常通过Go模块来完成：

go get github.com/xuri/excelize/v2

接下来，无论是新建一个Excel文件写入数据，还是打开一个现有文件读取内容，核心逻辑都围绕excelize.NewFile()和excelize.OpenFile()展开。

写入Excel文件：

package main

import (
    "fmt"
    "log"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile() // 创建一个新的Excel文件
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()

    // 设置单元格的值
    f.SetCellValue("Sheet1", "A1", "你好，世界！")
    f.SetCellValue("Sheet1", "B1", 100)
    f.SetCellValue("Sheet1", "C1", true)

    // 写入多行数据
    rows := [][]interface{}{
        {"姓名", "年龄", "城市"},
        {"张三", 30, "北京"},
        {"李四", 25, "上海"},
    }
    for i, row := range rows {
        startCell, err := excelize.CoordinatesToCellName(1, i+1) // A1, A2, A3...
        if err != nil {
            log.Println(err)
            continue
        }
        if err := f.SetSheetRow("Sheet1", startCell, &row); err != nil {
            log.Println(err)
        }
    }

    // 合并单元格，举个例子
    if err := f.MergeCell("Sheet1", "A5", "C5"); err != nil {
        log.Println(err)
    }
    f.SetCellValue("Sheet1", "A5", "这是一个合并的单元格")

    // 设置列宽
    f.SetColWidth("Sheet1", "A", "C", 20)

    // 保存文件
    if err := f.SaveAs("示例文件.xlsx"); err != nil {
        log.Println(err)
    }
    fmt.Println("Excel文件写入成功：示例文件.xlsx")
}

读取Excel文件：

package main

import (
    "fmt"
    "log"

    "github.com/xuri/excelize/v2"
)

func main() {
    f, err := excelize.OpenFile("示例文件.xlsx") // 打开一个现有的Excel文件
    if err != nil {
        log.Fatal(err)
    }
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()

    // 获取指定单元格的值
    cellA1, err := f.GetCellValue("Sheet1", "A1")
    if err != nil {
        log.Println(err)
    }
    fmt.Printf("A1单元格的值: %s\n", cellA1)

    // 遍历工作表中的所有行和单元格
    rows, err := f.GetRows("Sheet1")
    if err != nil {
        log.Println(err)
        return
    }
    fmt.Println("\n遍历所有数据:")
    for rowIndex, row := range rows {
        fmt.Printf("第 %d 行: ", rowIndex+1)
        for colIndex, colCell := range row {
            fmt.Printf("列 %d: %s | ", colIndex+1, colCell)
        }
        fmt.Println()
    }

    // 获取合并单元格的值，会返回合并区域左上角单元格的值
    mergedCellVal, err := f.GetCellValue("Sheet1", "A5")
    if err != nil {
        log.Println(err)
    }
    fmt.Printf("A5单元格（合并区域）的值: %s\n", mergedCellVal)
}

这些代码片段展示了excelize最基础也是最常用的读写操作。你会发现它的API设计得相当直观，基本上遵循了Excel本身的逻辑。

为什么选择 Excelize 库进行 Golang Excel 操作？

我个人觉得，在Go语言生态里处理Excel文件，excelize确实是一个非常值得信赖的选择。它不仅仅是因为功能全面，更在于它在性能、社区活跃度和易用性上做到了很好的平衡。

从我实际项目中的经验来看，excelize对xlsx格式的支持非常到位，这在当今Excel文件普遍采用xlsx格式的背景下显得尤为重要。它不依赖COM对象或其他外部库，纯Go实现，这让它在跨平台部署时省去了很多麻烦。比如，你不需要担心在Linux服务器上运行Go程序时，还需要额外安装Office组件。这种纯粹性，对于追求简洁和高效的Go开发者来说，简直是福音。

此外，excelize在处理大型文件时表现也相当不错，它提供了流式读写的功能，这对于内存有限但需要处理GB级别Excel文件的场景来说，简直是救命稻草。你不需要一次性把整个文件加载到内存里，这大大降低了OOM（内存溢出）的风险。而且，它的社区非常活跃，遇到问题时，通常能在GitHub Issues里找到类似的讨论或者快速获得帮助，这对于开发者来说，无疑增加了信心。

在实际项目中，使用 Excelize 读写大型 Excel 文件有哪些性能考量和优化策略？

处理大型Excel文件，性能确实是个绕不开的话题。我记得有一次，一个客户需要我们生成一个包含数十万行数据的报表，如果直接用普通写入方式，内存占用会飙升，甚至导致程序崩溃。这时候，excelize的流式处理就显得尤为关键了。

核心考量：内存与I/O

大型文件操作，最主要的就是内存消耗和磁盘I/O。excelize虽然优化得不错，但如果不注意，仍然可能遇到瓶颈。

流式写入 (Stream Writer)：这是处理大量数据写入的首选。excelize提供了NewStreamWriter方法，它允许你逐行写入数据，而不是一次性构建整个工作表结构。这样，每次写入的数据量很小，极大地减少了内存峰值。

// 示例：流式写入
f := excelize.NewFile()
sw, err := f.NewStreamWriter("Sheet1")
if err != nil {
    log.Fatal(err)
}
for rowID := 1; rowID <= 100000; rowID++ { // 写入10万行
    row := make([]interface{}, 10) // 假设每行10列
    for colID := 0; colID < 10; colID++ {
        row[colID] = fmt.Sprintf("单元格_%d_%d", rowID, colID)
    }
    cell, _ := excelize.CoordinatesToCellName(1, rowID)
    if err := sw.SetRow(cell, row); err != nil {
        log.Println(err)
    }
}
if err := sw.Flush(); err != nil { // 刷新缓冲区，确保所有数据写入
    log.Println(err)
}
if err := f.SaveAs("大文件流式写入.xlsx"); err != nil {
    log.Println(err)
}

流式写入的原理是，它不会在内存中完整地构建整个Excel文件的XML结构，而是将数据分批写入一个临时文件，最后再组合成完整的xlsx文件。这对于内存占用来说是质的飞跃。

流式读取 (Stream Reader)：类似地，当需要读取大型Excel文件时，也应该考虑流式读取。通过Rows()或Rows(sheetName)方法获取一个迭代器，可以逐行遍历数据，而不是一次性加载所有行。

// 示例：流式读取
f, err := excelize.OpenFile("大文件流式写入.xlsx")
if err != nil {
    log.Fatal(err)
}
rows, err := f.Rows("Sheet1")
if err != nil {
    log.Fatal(err)
}
defer rows.Close() // 记得关闭迭代器

for rows.Next() {
    row, err := rows.Columns()
    if err != nil {
        log.Println(err)
        continue
    }
    // 处理每一行数据
    // fmt.Println(row)
}
if err = rows.Err(); err != nil {
    log.Println(err)
}

这种方式可以避免一次性将所有数据加载到内存，尤其是在你只需要处理部分数据或者进行聚合计算时，效果显著。

避免不必要的样式和合并操作：样式和合并单元格会增加文件的复杂度和内存开销。如果不是必须，尽量减少这些操作。如果你真的需要设置样式，考虑批量设置或者利用SetCellStyle而不是逐个单元格设置。
关闭文件句柄：无论是读还是写，操作完成后务必调用f.Close()。这能确保文件资源被正确释放，避免潜在的内存泄漏或文件锁问题。尤其是在长时间运行的服务中，忘记关闭文件句柄可能会导致资源耗尽。

总的来说，处理大型Excel文件，核心就是“少即是多”——尽量减少内存中的数据量，通过流式处理来分摊压力。

除了基本的读写，Excelize 还能实现哪些高级的 Excel 操作？

excelize的功能远不止基本的单元格读写那么简单。它在很多方面都提供了相当强大的支持，这让它在处理复杂报表或数据可视化需求时显得游刃有余。

我个人在项目中就用过它来生成带有图表的年度报告，或者为数据设置条件格式来突出显示异常值。这些高级功能，使得生成的Excel文件不仅仅是数据的容器，更是信息传递的有效载体。

图表（Charts）：excelize支持创建多种类型的图表，比如柱状图、折线图、饼图、散点图等等。你可以指定数据系列、图表标题、轴标签，甚至自定义图表的样式。这对于需要将数据可视化呈现的场景非常有用，比如生成月度销售报告、项目进度图等。
```
// 简单示例：添加柱状图
// ... 前面写入数据的代码 ...
if err := f.AddChart("Sheet1", "E1", `{
    "type": "col",
    "series": [
        {"name": "Sheet1!$B$2", "categories": "Sheet1!$A$2:$A$3", "values": "Sheet1!$B$2:$B$3"}
    ],
    "title": {"name": "年龄分布"},
    "plotarea": {"show_bubble_size": true}
}`); err != nil {
    log.Println(err)
}
// 保存文件
// ...
```
这里的配置是JSON字符串，你需要根据excelize的文档来构建正确的图表配置。这部分虽然稍微复杂一点，但一旦掌握，就能生成非常专业的图表。
图片（Images）：你可以在Excel文件中插入图片，这对于品牌logo、产品图片或者图示说明等场景非常实用。你可以控制图片的位置、大小，甚至设置打印属性。
```
// 示例：插入图片
// 假设当前目录下有 logo.png
if err := f.AddPicture("Sheet1", "D1", "logo.png", nil); err != nil {
    log.Println(err)
}
// ...
```
合并单元格与拆分（Merge Cells）：这个前面已经提到了，它允许你将多个单元格合并成一个大单元格，或者解除合并。这在制作表头、标题或需要跨多列/行显示内容的表格时非常常用。
公式（Formulas）：excelize支持设置单元格公式，这意味着你可以在Go程序中定义Excel的计算逻辑，而不是在Excel中手动输入。这对于生成动态计算的报表非常有用。
```
// 示例：设置公式
f.SetCellValue("Sheet1", "D2", "=SUM(B2:C2)") // 假设B2和C2有数字
// ...
```
数据验证（Data Validation）：你可以为单元格设置数据验证规则，比如限制输入只能是数字、日期，或者从一个列表中选择。这对于确保数据质量非常重要。
条件格式（Conditional Formatting）：根据单元格的值或其他规则，自动应用不同的格式（字体颜色、背景色等）。这能让关键数据一目了然。比如，销售额低于某个阈值的单元格显示为红色。
冻结窗格（Freeze Panes）：在查看大型表格时，冻结行或列可以保持标题可见，提高用户体验。excelize也提供了相应的方法。
自定义样式（Custom Styles）：除了基本的字体、颜色设置，你还可以创建复杂的样式，包括边框、填充、对齐方式、数字格式等，并将其应用于多个单元格。这使得生成的Excel文件具有高度的定制化和专业性。