excelize/v2是go生态中唯一稳定支持.xlsx全功能(公式、样式、合并单元格、多sheet)且持续维护的纯go库;避免逐单元格写入,应批量使用setsheetrow/rows;导入时须校验sheet名而非依赖索引;需显式设置字体、日期、文本格式以防乱码和类型错误。

用 github.com/xuri/excelize/v2 做导入导出最稳
直接上结论:别碰 tealeg/xlsx(已归档、不维护),也别自己封装 encoding/csv 去硬啃 Excel 格式。当前 Go 生态里,excelize/v2 是唯一能稳定处理 .xlsx(含公式、样式、合并单元格、多 sheet)且持续更新的库。
它底层不依赖外部程序或 CGO,纯 Go 实现,交叉编译友好;v2 版本强制要求 Go 1.16+,修复了 v1 中大量并发写入 panic 和内存泄漏问题。
安装命令就是:
go get github.com/xuri/excelize/v2
导出时避免 SetCellValue 逐单元格写——性能差十倍
常见错误是循环里反复调用 f.SetCellValue("Sheet1", "A"+strconv.Itoa(i), data[i])。这会触发大量内部 map 查找和样式缓存重建,1 万行数据可能耗时 3s+。
正确做法是批量写入:
- 用
f.SetSheetRow("Sheet1", "A1", &dataSlice)直接灌入一整行切片([]interface{}) - 若数据是结构体切片,先转成二维
[][]interface{},再用f.SetSheetRows一次性写入 - 写完务必调用
f.SaveAs("out.xlsx"),别漏掉——它才是真正序列化为 ZIP 包的过程
注意:SetSheetRow 的起始坐标必须是字符串(如 "A1"),不是数字索引;列名超过 Z 后是 AA、AB,库会自动处理,不用自己算。
导入时小心 f.GetSheetList() 和 f.GetSheetName(0) 的区别
Excel 文件可能有隐藏 sheet 或被重命名的 sheet,仅靠索引取名容易错位。比如用户删了第一个 sheet,f.GetSheetName(0) 就会返回第二个 sheet 的名字,但你代码还按“第一个是主数据表”逻辑跑,数据就全偏了。
稳妥做法是显式指定要读的 sheet 名:
- 先用
f.GetSheetList()拿到所有 sheet 名列表 - 检查目标 sheet 是否存在:
if !slices.Contains(sheets, "用户数据") - 再用
f.GetSheetMap()获取 name→index 映射,避免硬编码索引
读单元格值统一用 f.GetCellValue("用户数据", "B3"),它自动处理数字/日期/布尔类型的类型转换;如果需要原始类型(比如区分空字符串和 nil),改用 f.GetCellRawValue。
中文乱码、时间格式错乱、数字变科学计数法——全因没设单元格类型
Excel 单元格有显示格式(format)和存储类型(type)两个概念。excelize 默认把字符串当通用类型写入,Excel 客户端会按自己的规则二次解析,导致:
- 中文保存后打开显示为方块:没在
f.NewSheet()后设置默认字体,或写入前没调f.SetCellStyle绑定含 UTF-8 支持的字体(如"SimSun"或"Microsoft YaHei") - 时间变成数字(如 44562):写入前需调
f.SetCellDateTime,而不是SetCellValue;读取时用f.GetCellDateTime才能还原为time.Time - 长数字(如身份证号)变 1.23E+17:写入前用
f.SetCellStr强制当字符串,或提前给整列设格式"@"(文本格式)
这些细节不写进代码,导出文件在 Excel 里看着正常,但用 Python pandas 或其他工具二次读取时大概率出错。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











