golang如何编写Excel导入导出工具_golang Excel导入导出工具编写实战

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《golang如何编写Excel导入导出工具_golang Excel导入导出工具编写实战》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

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如何编写Excel导入导出工具_golang Excel导入导出工具编写实战》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！