excelize/v2是go生态中生成excel最稳妥的选择，纯go实现、无需外部依赖、支持流式写入且兼容.xlsx格式；使用newfile()创建工作簿后须defer f.close()，默认含sheet1，写入推荐setcellvalue()以保障数值类型，导出优先用writeto()而非saveas()。
excelize/v2 是目前 Go 生态中生成 Excel 文件最稳妥的选择——它不依赖外部程序、纯 Go 实现、支持流式写入，且对 .xlsx 格式兼容性极好。别折腾 tealeg/xlsx 或手撕 ZIP/XML，那些要么已停止维护，要么在大数据量下容易内存爆掉。
如何用 excelize.NewFile() 创建空白工作簿
这是所有操作的起点，但新手常忽略两个关键点：资源释放和默认 sheet 管理。
-
excelize.NewFile()默认会创建一个名为Sheet1的工作表，无需手动调用NewSheet() - 必须显式调用
defer f.Close()，否则在并发场景下可能触发文件句柄泄漏或 panic（尤其在 Web 服务中） - 如果后续要删掉默认 sheet，得先用
f.GetSheetMap()查 ID，再调用f.DeleteSheet()；直接删Sheet1可能导致保存失败
写入数据时该用 SetCellValue() 还是 SetCellStr()
二者行为差异直接影响数值类型识别和后续 Excel 公式计算：
-
SetCellValue("Sheet1", "A1", 123)→ 单元格值为数字类型，Excel 中可参与求和、排序 -
SetCellStr("Sheet1", "A1", "123")→ 值为文本类型，即使看起来像数字，也无法被=SUM(A1:A10)正确识别 - 时间类型推荐用
time.Time直接传入SetCellValue()，excelize会自动转为 Excel 序列号并设置正确格式；若用字符串则需额外调用SetCellStyle()配置日期格式
保存文件前必须调用 SetActiveSheet() 吗？
不是必须，但不调用会导致用户打开文件时看到的是第一个创建的 sheet（不一定是你要展示的主表），体验差。
- 新建文件后，
Sheet1的 index 是 0，但SetActiveSheet(0)并不保险——因为如果你中间调用了NewSheet()，index 顺序可能变化 - 更可靠的做法是：用
f.GetSheetMap()获取 map，再根据 sheet 名查 index，例如f.SetActiveSheet(f.GetSheetMap()["数据报表"]) - 如果只是生成下载流（如 HTTP 响应），
SaveAs()不是必须的；可用f.WriteTo(w io.Writer)直接写入 response body，避免临时文件 IO
为什么 SaveAs() 报错 open /path/to/file.xlsx: permission denied？
这个错误往往不是权限问题，而是路径语义误判：
- 传入的路径如果是相对路径（如
"report.xlsx"），SaveAs()会尝试写入当前工作目录，而 Web 服务常以非 root 用户运行，且工作目录可能是/或只读挂载点 - 解决方法：用绝对路径 + 显式目录检查，例如
os.MkdirAll("/tmp/excel", 0755)，再保存到/tmp/excel/report.xlsx - 更推荐绕过磁盘：Web 场景下优先走
WriteTo()写入http.ResponseWriter，既快又省空间
实际开发中最容易被跳过的细节是：没有验证 sheet 名是否合法。Excel 对 sheet 名有长度（≤31 字符）、禁用字符（\ / ? * [ ]）、不能全空格等限制，excelize 不会在 NewSheet() 时校验，但保存时直接 panic。建议封装一层 safeNewSheet() 做预处理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
