Go操作Excel实战详解：github.com/xuri/excelize/v2

在开发 Excel 批量处理工具时，例如多 Sheet 汇总、批量清理公式、XLSX 转换、报表生成等，如果不希望依赖 Windows COM 或本地安装 Excel，那么最合适的方案是：

github.com/xuri/excelize/v2

这是目前 Go 生态中最成熟、使用最广泛的 Excel 操作库之一。

一、excelize 是什么

excelize 是一个纯 Go 实现的 Excel 读写库。

项目作者是 Xuri。

核心特点：

不依赖 Excel 软件
支持 Windows / macOS / Linux
适合桌面程序和服务器程序
支持 xlsx、xlsm、模板文件
性能稳定
API 设计清晰

它本质是直接操作 Office Open XML 结构，而不是调用 Excel 进程。

二、为什么推荐 excelize

和 COM 方案相比：

excelize 的优势：

不需要安装 Office
不会残留 Excel 进程
不存在 COM 线程模型问题
可以运行在服务器环境
更适合批量自动化处理

COM 方案适合需要调用宏或真实 Excel 功能的场景。

如果只是做：

Excel 数据合并
批量清理公式
批量导出报表
SaaS 报表下载
CSV 转 XLSX

excelize 是更优解。

三、基础使用示例

创建 Excel 文件

go 复制代码

package main

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

func main() {
	f := excelize.NewFile()

	f.SetCellValue("Sheet1", "A1", "Hello")
	f.SetCellValue("Sheet1", "B1", 123)

	f.SaveAs("test.xlsx")
}

打开并读取文件

go 复制代码

f, err := excelize.OpenFile("test.xlsx")
if err != nil {
	panic(err)
}

value, _ := f.GetCellValue("Sheet1", "A1")
println(value)

遍历整张表

go 复制代码

rows, _ := f.GetRows("Sheet1")

for _, row := range rows {
	for _, col := range row {
		print(col, "\t")
	}
	println()
}

四、常见实战场景

结合实际开发经验，下面是几个高频需求示例。

1. 批量清理公式（将公式转为值）

go 复制代码

rows, _ := f.GetRows("Sheet1")

for i, row := range rows {
	for j := range row {
		cell, _ := excelize.CoordinatesToCellName(j+1, i+1)
		value, _ := f.GetCellValue("Sheet1", cell)
		f.SetCellValue("Sheet1", cell, value)
	}
}

适合做 Excel 表格公式批量清理工具。

2. 多 Sheet 数据汇总

go 复制代码

target := excelize.NewFile()

for _, sheet := range f.GetSheetList() {
	rows, _ := f.GetRows(sheet)
	for i, row := range rows {
		for j, val := range row {
			cell, _ := excelize.CoordinatesToCellName(j+1, i+1)
			target.SetCellValue("Sheet1", cell, val)
		}
	}
}

适合多表汇总工具。

3. 设置样式

go 复制代码

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

f.SetCellStyle("Sheet1", "A1", "A1", style)

4. 插入图片

go 复制代码

f.AddPicture("Sheet1", "A1", "logo.png", nil)

五、大数据处理建议

如果数据量超过 5 万行，建议使用流式写入。

go 复制代码

streamWriter, _ := f.NewStreamWriter("Sheet1")

row := []interface{}{"ID", "Name", "Price"}
streamWriter.SetRow("A1", row)

streamWriter.Flush()

优点：

内存占用低
写入速度快
适合报表导出

六、性能优化建议

大文件使用 StreamWriter
避免频繁调用 Save
多文件处理可以并发
尽量减少重复读取单元格

七、常见问题

不支持 .xls

excelize 仅支持：

.xlsx
.xlsm
.xltx

旧版 .xls 需要转换后再处理。

公式不会自动计算

excelize 不会像 Excel 一样执行公式。

读取到的是缓存值。

如果文件从未被 Excel 计算过，公式结果可能为空。

内存占用问题

普通模式会加载整个文件到内存。

超大文件建议：

使用流式 API
分批处理

八、典型应用架构

如果在桌面工具中使用，例如 Wails 项目：

前端 Vue ↓ Go 后端 ↓ excelize ↓ 生成或处理 Excel

优点：

无需依赖 Excel
不会出现 COM 崩溃
更容易打包分发

九、总结

github.com/xuri/excelize/v2 是目前 Go 生态中最成熟的 Excel 操作库。

适合：

Excel 批量处理
报表生成
数据清洗
CSV 转 XLSX
模板填充

如果你的项目目标是稳定、跨平台、高性能批量处理，那么 excelize 是首选方案。