excelize/v2是Go生态中唯一稳定支持.xlsx全功能且持续维护的纯Go库；它支持样式、公式、多Sheet、流式写入，而encoding/csv仅能输出无格式纯文本，无法满足真实Excel需求。
Go 本身不内置 Excel 支持，必须依赖第三方库；github.com/xuri/excelize/v2 是目前最成熟、维护活跃、支持 .xlsx（非 .xls）且无 Office 依赖的首选方案。
为什么不用 encoding/csv 导出“伪 Excel”
CSV 文件双击虽能被 Excel 打开，但本质是纯文本：不支持单元格样式、合并、公式、日期格式自动识别、多工作表等。用户导出后若需打印、加粗标题、冻结首行，会立刻卡住。真正需要 Excel 的场景，绕不开 excelize。
- Excel 打开 CSV 时默认用逗号分隔，若字段含逗号或换行符，会错列 ——
excelize自动转义 - 时间类型如
time.Time写入 CSV 是字符串，Excel 不识别为日期；excelize可写入原生 Excel 日期序列值 - 导出报表类需求（带标题行、数字右对齐、金额加千分位）必须操作单元格样式，CSV 做不到
用 excelize 写入结构体切片到单个工作表
核心是把数据映射到行列坐标，而非“绑定模型”。没有 ORM 式的自动映射，但足够直观可控。
- 先调用
f := excelize.NewFile()创建空白工作簿，默认带一个名为Sheet1的工作表 - 用
f.SetCellValue("Sheet1", "A1", "姓名")写入标题；注意行列地址是 Excel 风格（"B3"），不是数组下标 - 遍历结构体切片，按行号递增写入：
f.SetCellValue("Sheet1", fmt.Sprintf("A%d", i+2), user.Name) - 写完务必调用
f.SaveAs("report.xlsx")或f.Write(w io.Writer)输出，否则内存中没落地
// 示例：导出 User 切片
type User struct {
Name string `json:"name"`
Score int `json:"score"`
At time.Time `json:"at"`
}
users := []User{{"张三", 95, time.Now()}, {"李四", 87, time.Now().Add(-24 * time.Hour)}}
<p>f := excelize.NewFile()
f.SetCellValue("Sheet1", "A1", "姓名")
f.SetCellValue("Sheet1", "B1", "分数")
f.SetCellValue("Sheet1", "C1", "时间")</p><p>for i, u := range users {
row := i + 2 // 标题占第1行，数据从第2行开始
f.SetCellValue("Sheet1", fmt.Sprintf("A%d", row), u.Name)
f.SetCellValue("Sheet1", fmt.Sprintf("B%d", row), u.Score)
f.SetCellDateTime("Sheet1", fmt.Sprintf("C%d", row), u.At, "yyyy-mm-dd hh:mm:ss")
}
f.SaveAs("users.xlsx")
常见报错和兼容性注意点
excelize 对 Go 版本和 Excel 特性有明确边界，踩坑多发生在忽略文档细节时。
-
SetCellDateTime写入时间前，必须确保该单元格格式已设为日期类型，否则 Excel 显示为数字（如 45123）—— 要配f.SetCellStyle+ 内置数字格式 ID（如22对应yyyy-mm-dd） - Windows 下生成的文件若在 macOS Excel 中打开乱码，大概率是未设置 UTF-8 BOM ——
excelize默认处理得当，但若用os.Create后手动写入，需自己加 BOM - 并发写入同一
*excelize.File实例会 panic；导出接口被高并发调用时，必须每个请求 new 一个excelize.File - v2 版本不兼容 v1 的 API（如
SetRow被移除），升级时检查go.mod是否锁死在v1.x
真正难的不是写几行数据，而是让导出的 Excel 在用户手里“开箱即用”：列宽自适应、标题加粗、数值右对齐、错误值不显示为 #VALUE!。这些都得一行行调 SetColWidth、SetCellStyle，没有捷径。
