Gin默认响应体缓冲会导致大CSV导出内存溢出，正确做法是绕过Gin封装，直接操作http.ResponseWriter：先WriteHeader()设状态码和Content-Type，再手动写Content-Disposition头，用Write()分块写入CSV行并定期Flush()，全程禁用c.String()等缓存方法。
导出大文件时内存爆掉，Gin 默认响应体缓冲怎么破
直接用 c.String() 或 c.Data() 写入几 MB 以上的 CSV，Gin 会先把整个内容塞进内存再发出去，OOM 是常态。根本原因是 Gin 的 ResponseWriter 默认使用 bytes.Buffer 缓存响应，没做流式处理。
正确做法是绕过 Gin 的响应缓冲，直接操作底层 http.ResponseWriter 的 Write() 方法，并配合 flush 控制输出节奏：
- 调用
c.Writer.WriteHeader()显式设置状态码和Content-Type - 手动写入 HTTP 头部字段，比如
Content-Disposition: attachment; filename="data.csv" - 用
c.Writer.Write()分块写入 CSV 行，每写若干行后调用c.Writer.Flush() - 避免使用
c.JSON()、c.String()等封装方法，它们会触发缓冲
csv.Writer 写入 http.ResponseWriter 为啥报错“write on closed body”
常见错误是提前结束请求（比如中间件 panic、超时、或显式调用了 c.Abort()），但还在往响应体写数据。更隐蔽的问题是：Gin 在 handler 返回后自动调用 Flush() 和关闭连接，而你手动写的 Flush() 如果在 handler return 之后执行，就会遇到底层连接已关闭。
关键约束：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 所有
csv.Writer的Write()和Flush()必须在 handler 函数返回前完成 - 不要把
csv.Writer传到 goroutine 里异步写 ——http.ResponseWriter不是并发安全的 - 如果数据来自数据库游标（如
sql.Rows），确保rows.Close()在 handler 结尾调用，且不能早于 CSV 写完 - 用
defer rows.Close()要小心：它会在函数 return 时执行，可能早于最后一行 CSV 写出
如何边查数据库边写 CSV，不加载全量数据到内存
核心是让数据库驱动按需返回行，而不是 rows.Scan() 全部读进 slice。PostgreSQL（pq）和 MySQL（mysql）驱动都支持流式迭代，但必须禁用内部缓冲。
实操要点：
- MySQL 驱动：连接串加参数
?readTimeout=0&writeTimeout=0&timeout=0&multiStatements=true，并确认没开启sql.DB.SetMaxOpenConns(1)这类限制 - PostgreSQL 驱动：用
pgx.Conn.QueryRow()或pgx.Conn.Query()，不要用pgxpool—— pool 会预取多行，破坏流式语义 - 每从
rows.Next()拿到一行，立刻用csvWriter.Write()输出，然后调用c.Writer.Flush()（建议每 100 行 flush 一次） - 字段类型要显式转换：数据库的
NULL值在 Go 中是sql.NullString等，直接传给csvWriter.Write()会 panic，得先转成字符串
中文乱码、Excel 打不开 CSV 的编码和 BOM 问题
Excel 默认用 ANSI（GBK/GB2312）打开 CSV，而 Go 的 csv.Writer 输出的是 UTF-8。不加 BOM，Excel 就当 ANSI 解析，中文全变乱码；加了 BOM，又可能被某些 CLI 工具当成非法字符。
稳妥方案：
- 输出前写入 UTF-8 BOM：
c.Writer.Write([]byte("\xef\xbb\xbf"))，放在所有 CSV 内容之前 - 不要依赖
content-type的charset=utf-8—— Excel 完全忽略它 - 如果后端要兼容 Linux CLI 查看，可提供两个 endpoint：一个带 BOM（供 Excel）、一个不带（供终端），用 query 参数区分
- 字段含逗号、换行符、双引号时，
csv.Writer会自动加引号和转义，别自己拼接 —— 否则 Excel 解析失败
http.ResponseWriter 当原始流来用，控制好 flush 时机、BOM 位置、SQL 游标生命周期，这三处漏掉任何一环，导出就卡在半路或打不开。 
