必须结合流式写入、异步任务和文件生命周期管理，否则易OOM或阻塞HTTP连接；因为excelize.NewFile()默认全量缓存工作簿结构，每调用SetCellValue()都构建XML节点树，10万行×20列致数百MB内存占用、GC压力大，Write()序列化时可能触发goroutine阻塞。
导出大型报表不能只靠 excelize 一次性写入内存，必须结合流式写入、异步任务和文件生命周期管理，否则容易 OOM 或阻塞 HTTP 连接。
为什么直接用 excelize.Write() 导出万行数据会卡死或崩溃
因为 excelize.NewFile() 默认把整个工作簿结构缓存在内存里，每调用一次 SetCellValue() 都在构建 XML 节点树；10 万行 × 20 列 ≈ 数百 MB 内存占用，GC 压力大，且 Write() 最终序列化时可能触发 goroutine 阻塞。
- 实测：5 万行数据在 2GB 内存容器中大概率触发
runtime: out of memory -
excelize/v2提供了f.Stream()模式，但 Gin 的c.Writer不支持 seek，无法直接传给流式接口 - 正确做法是先写到临时文件（
os.CreateTemp），再用http.ServeContent流式传输
如何用 excelize + 临时文件实现流式导出
绕过内存瓶颈的核心是「分离生成与响应」：Excel 文件生成阶段不走 HTTP Writer，而是落地为磁盘临时文件；响应阶段用 http.ServeContent 按需读取并传输。
- 用
os.CreateTemp("", "export-*.xlsx")创建带随机后缀的临时文件，避免并发冲突 - 生成完成后立即
defer os.Remove(tempPath)，但注意：必须在http.ServeContent返回后再删，否则可能中断传输 - 响应头必须设
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，不能用octet-stream，否则 Chrome 下载后可能打不开 - 中文文件名要用
url.QueryEscape("报表-20260813.xlsx")+filename*=UTF-8''...格式，否则 Safari 会乱码
f, _ := os.CreateTemp("", "export-*.xlsx")
defer os.Remove(f.Name()) // 注意：这里只是注册清理，实际删除时机由 ServeContent 控制
file := excelize.NewFile()
// ... 写入逻辑（建议分批写入，比如每 5000 行调用一次 f.Save()）
_ = file.SaveAs(f.Name())
http.ServeContent(c.Writer, c.Request, filepath.Base(f.Name()), time.Now(), f)
异步导出任务怎么和 Gin 接口解耦
用户请求 /api/export?report=user_active 时，你不该同步跑完全部 SQL 查询 + Excel 生成，而应立刻返回任务 ID，并让后台 goroutine 处理。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 任务状态建议存内存 map + TTL（如
sync.Map+ 定时清理），或轻量存储如 BadgerDB；不用 MySQL，避免小任务也压 DB - 导出完成后的文件路径要可追溯，推荐命名规则：
export/{task_id}/{report_type}-{unix_sec}.xlsx - 前端轮询
/api/export/status?id=xxx，后端返回{"status":"done","url":"/download/xxx.xlsx"}，URL 对应一个带签名的短期有效链接（防遍历） - 务必设置超时：SQL 查询加
context.WithTimeout，Excel 生成加select { case ，防止 goroutine 泄漏
导出 CSV 和 Excel 在 Gin 中的关键差异点
CSV 看似简单，但在真实场景下比 Excel 更容易出兼容性问题，尤其涉及中文、特殊字符、换行符。
- CSV 必须写 UTF-8 BOM（
[]byte{0xEF, 0xBB, 0xBF}），否则 Windows Excel 默认用 ANSI 打开，中文全变问号 - 字段含换行符（\n）、逗号、双引号时，
csv.Writer会自动加引号和转义，但你得确保原始数据没破坏结构（比如没手动拼接 CSV 字符串） - Excel 不需要 BOM，但单元格内容含公式或数字格式时，
SetCellValue可能被当成字符串；要用SetCellFormula或SetCellStyle显式控制类型 - 大 CSV 导出可直接
c.Writer.Write()流式写入，无需临时文件；但 Excel 必须落盘，因excelize不支持 writer-only 模式
真正难的不是写几行 SetCellValue，而是当导出耗时超过 30 秒、失败重试、用户中途关闭页面、文件清理遗漏、并发生成同名临时文件时，系统是否还稳。这些边界情况，比选哪个库重要得多。
