应使用excelize.newstreamwriter流式写入，避免newfile全量加载导致oom；需显式设字体、日期格式及列宽，并用context控制超时与取消。
导出大文件时内存暴涨甚至 OOM
用 excelize 或 tealeg/xlsx 直接在 Gin 的 HTTP handler 里构建完整 Excel 再写入 c.Writer，很容易触发内存爆炸——尤其当报表含数万行、多张 Sheet、带样式或图片时。Gin 默认不流式响应，SetHeader("Content-Disposition", ...) 后若先生成整个 *xlsx.File 对象再调用 Write，Go runtime 会把全部数据暂存在内存。
解决思路是绕过内存缓冲，边生成边写入 ResponseWriter：
- 用
excelize.NewStreamWriter替代excelize.NewFile，它返回可流式写入的*excelize.StreamWriter - 调用
c.Writer.WriteHeader(200)和c.Header().Set(...)显式设置响应头（注意不能用c.JSON或c.Data） - 创建
io.MultiWriter(c.Writer, ...)可选加进度日志或压缩（如gzip.NewWriter），但注意 Gin 默认不支持 gzip 流式编码，需手动处理 - 每写完一个 Sheet 调用
sw.Flush()，避免内部 buffer 积压
并发导出多个大型报表导致 goroutine 泄漏
用户频繁点击“导出”按钮，后端若对每个请求都起 goroutine 异步生成 Excel 并塞进全局 channel，又没做限流或超时控制，很快会堆积大量阻塞的 sw.WriteRow 调用，goroutine 状态变成 IO wait 却无法回收。
必须主动约束并发和生命周期：
- 用带缓冲的 channel + worker pool 控制最大并发数（例如
make(chan *ExportTask, 10)） - HTTP handler 中设置
c.Request.Context().Done()监听，一旦客户端断开（如关页、刷新），立即取消context.WithTimeout下游操作 - 避免在 goroutine 中直接调用
c.Writer—— Context 取消后Write会 panic，应提前判断ctx.Err() != nil - Excel 生成失败时，用
http.Error(c.Writer, "...", http.StatusInternalServerError)返回错误，而非继续写入部分文件
中文乱码、数字格式错乱、日期显示为浮点数
这是 excelize 的常见坑：默认不设字体、不设单元格类型，纯靠 Go 值反射推断。字符串写入后 Excel 可能识别成“常规”格式，中文变方块；float64 时间戳被当数值显示成 44562.732…
关键配置必须显式写：
- 用
sw.SetColWidth("Sheet1", "A", "Z", 15)防止中文被截断 - 写入前调用
sw.SetCellStyle("Sheet1", "A1", "A1", styleID)，其中styleID由f.NewStyle(&excelize.Style{Font: &excelize.Font{Family: "微软雅黑", Size: 10}})创建 - 日期字段不用
time.Time.String()，改用excelize.ToSheetDate(time.Now(), false)转为 Excel 底层浮点数，并配合SetCellStyle设NumFmt: 22（对应 yyyy-mm-dd） - 数字列用
strconv.FormatFloat(x, 'f', 2, 64)转字符串再写，或设NumFmt: 2（千分位+两位小数）
Gin 中如何安全传递导出参数并校验
报表常需按时间范围、部门 ID、状态等动态筛选，但直接从 c.Query("start_time") 拿字符串再解析，容易因格式错误 panic 或 SQL 注入（如果拼进查询语句）。
推荐组合方案：
- 用
c.ShouldBindQuery(¶ms)绑定结构体，字段加binding:"required,datetime=2006-01-02"校验 - 敏感参数（如
dept_id）在绑定后查数据库确认是否存在，避免前端伪造 ID 导致越权导出 - 大数据量导出加
limit参数硬限制（如最大 50 万行），并在 SQL 层用LIMIT+OFFSET分页拉取，别一次性SELECT * - 避免把原始 SQL 条件拼进 Excel 文件名：
c.Header().Set("Content-Disposition", fmt.Sprintf(`attachment; filename="%s.xlsx"`, url.PathEscape(filename)))，防止 XSS 或路径穿越
流式写 Excel 的核心是别让数据在内存里“堆起来”，而 Gin 的 context 生命周期和 error 处理稍不注意就会让整个导出流程卡死或崩溃。真正上线时，记得压测单个导出接口的内存增长曲线，而不是只看 CPU 或 QPS。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
