生产环境推荐 excelize（功能全、支持流式写入）或 goxlsx/xlsx（轻量、仅基础读写）；解析时需注意类型转换、空行处理、编码与合并单元格；导出大数据量应使用 StreamWriter 并手动 GC；数据库导出前须做类型桥接与列名清洗，并用 OpenFile 校验文件完整性。
Go 读写 Excel 文件该选哪个库
生产环境别碰 tealeg/xlsx（已归档，不维护），也别手写 XML 解析。目前稳定、活跃、文档相对清晰的只有两个：qax911/excelize 和 goxlsx/xlsx。前者支持 .xlsx 全功能（公式、样式、图表、流式写入），后者轻量但只支持基础单元格读写。如果你要处理带格式的报表或导出百万行数据，直接上 excelize；如果只是解析后台日志导出的纯数据表（无合并单元格、无样式），xlsx 启动快、内存占用低。
用 excelize 导入 Excel 时常见的解析错误
最常踩的坑是没设 RawCellValue 或忽略日期/数字类型自动转换：
-
sheet.GetRow(1)返回的字符串可能是 “44562” 而不是 “2022/1/1”——这是 Excel 底层的序列号，需调用sheet.GetCell(x, y).GetTime()或.GetFloat()手动转 - 空行被跳过？检查是否启用了
Options.SkipEmptyRows = true（默认 false，但某些版本文档误写） - 中文列名乱码？确保文件本身是 UTF-8 编码（Excel 默认保存为 ANSI 的话，
excelize会读成乱码，必须用其他工具先转存） - 合并单元格只读左上角值？对，
GetCell不自动展开合并区域，得先调sheet.GetMergeCells()获取范围再手动填充
导出大数据量 Excel 的内存与性能控制
一次性构造百万行 *xlsx.Sheet 对象会 OOM。正确做法是用流式写入：
- 初始化用
f := excelize.NewFile()，不要f.NewSheet()后反复f.SetCellValue() - 改用
f.NewStreamWriter("Sheet1")，然后循环调用sw.WriteRow([]interface{}{"a", 123, time.Now()})，最后sw.Flush() - 每写 10 万行主动
runtime.GC()一次（实测能压降 30% 峰值内存） - 禁用自动计算：导出前设
f.SetCalculation(&excelize.Calculation{CalcMode: "manual"})，避免写入公式时触发重算
如何安全地把数据库查询结果导出为 Excel
别把 rows.Scan() 结果直接塞进 WriteRow——类型不匹配会 panic。稳妥做法是统一转 interface{} 并做类型桥接：
立即学习“go语言免费学习笔记（深入）”；
// 示例：处理 sql.NullString / sql.NullInt64 等
var val interface{}
switch v := col.(type) {
case nil:
val = ""
case sql.NullString:
val = v.String
case sql.NullInt64:
val = v.Int64
default:
val = fmt.Sprintf("%v", v)
}
row = append(row, val)
另外，导出前务必检查字段名是否含非法字符（如斜杠、冒号），否则 SetSheetRow 会静默失败；建议用 strings.Map(func(r rune) rune { if unicode.IsLetter(r) || unicode.IsDigit(r) || r == '_' { return r } else { return -1 } }, name) 清洗列头。
真正麻烦的从来不是“怎么写”，而是“怎么让 Excel 打开不报‘发现不可读内容’”。合并单元格越界、样式 ID 重复、日期格式串错——这些错误不会在 Go 侧报错，只会在双击打开时弹窗。建议每次导出后加一步校验：excelize.OpenFile(filename) 再 close，它会在打开阶段触发底层 XML 校验。
