Go导出CSV需解决四大问题：加UTF-8 BOM防中文乱码；用writer.Write自动转义特殊字符；大数据量时调大缓冲区并定期Flush防OOM；明确定义表头顺序避免错乱。
Go 语言导出 CSV 数据本身很简单，但真正上线用时，90% 的问题出在编码、特殊字符、内存控制和表头顺序上，不是 csv.Writer 写不写得出来，而是写出来的文件 Excel 打不开、中文乱码、某列数据被吞掉、大文件 OOM。
CSV 导出中文乱码（Excel 打开是方块或问号）
根本原因：Excel 默认用系统 ANSI 编码（Windows 是 GBK/GB2312）读 CSV，而 Go csv.Writer 输出的是 UTF-8 —— 二者不兼容。不是 Go 写错了，是 Excel 没“认出”这是 UTF-8。
- 最稳妥方案：在 CSV 文件开头写入 UTF-8 BOM（
\xEF\xBB\xBF），Excel 就能自动识别 - 不要用
golang.org/x/text/encoding转 GBK —— 兼容性差，且非标准，其他工具（如 LibreOffice、Python pandas）会读错 - 示例写法：
file, _ := os.Create("data.csv") // 写 BOM file.Write([]byte("\xEF\xBB\xBF")) writer := csv.NewWriter(file) writer.Write([]string{"姓名", "城市"}) writer.Write([]string{"张三", "上海"}) writer.Flush()
导出含逗号、换行、双引号的字段（Excel 列错位或报错）
csv.Writer 默认会自动处理：字段含逗号或换行时，自动用双引号包裹；字段含双引号时，会转义为两个双引号（" → ""）。但前提是——你别手动拼接字符串。
- 绝对不要：
fmt.Fprintf(w, "%s,%s\n", name, city)—— 这绕过了 CSV 转义逻辑，一遇到换行就崩 - 必须用
writer.Write([]string{...})，让标准库处理转义 - 如果字段本身含双引号（比如用户输入了
他说："你好"），csv.Writer会自动变成"他说：""你好"""，Excel 完全能正确解析 - 注意：
writer.Comma可改分隔符，但 Excel 默认只认英文逗号；若强行设为\t，应改用 TSV 并命名为.tsv，否则 Excel 导入向导里要手动选分隔符
大数据量导出卡死或 OOM（百万行以上）
csv.Writer 自带缓冲，默认 4KB，对小数据够用；但导出 50 万行时，如果每行 200 字节，光缓冲区就可能累积 100MB+ 内存，尤其配合 http.ResponseWriter 直接写 HTTP 响应时更危险。
立即学习“go语言免费学习笔记（深入）”；
- 调大缓冲区：
writer := csv.NewWriter(bufio.NewWriterSize(w, 64*1024))（64KB） - 关键动作：每写完 1000 行，显式调用
writer.Flush()—— 把缓冲内容推给底层 writer（比如文件或 HTTP 连接），释放内存 - 避免一次性把所有数据 load 进内存再循环写；应从数据库游标（
rows.Next()）边读边写 - HTTP 导出场景下，记得设响应头：
w.Header().Set("Content-Type", "text/csv; charset=utf-8")和w.Header().Set("Content-Disposition", `attachment; filename="data.csv"`)
表头顺序错乱或字段缺失（结构体导出常见）
用结构体生成 CSV 表头和数据时，Go 没有内置反射字段顺序保证。reflect.StructTag 可控，但字段遍历顺序是随机的（Go 1.19+ 仍不保证 struct 字段反射顺序）。
- 不要依赖
reflect.ValueOf(&s).Elem().NumField()循环取字段顺序 - 推荐做法：明确定义字段顺序切片，比如
headers := []string{"ID", "Name", "Email"}，然后按此顺序从结构体取值（可用reflect.Value.FieldByName或更安全的map[string]interface{}映射） - 或者用轻量库如
gocsv（注意它也依赖 tag，且默认不支持 BOM，需自己加） - 字段为空值（
nil、空字符串、零值）是否导出？由业务决定，csv.Writer不过滤，你得在Write()前做判断
BOM、自动转义、流式 Flush、显式字段顺序——这四点没踩准，导出的 CSV 在真实环境中基本等于废件。尤其别信“本地测试能打开就行”，不同 Excel 版本、Mac/Windows 系统、甚至同一台机器上双击 vs 右键→打开方式，行为都可能不同。
