Go写CSV推荐标准库encoding/csv,支持自动转义特殊字符、流式写入和BOM添加;需调用Flush()和Close()确保数据落盘,结构体导出建议手动映射为字符串切片。

在 Go 语言中写入 CSV 文件,推荐使用标准库 encoding/csv,它轻量、安全、支持流式写入,且能自动处理字段中的逗号、换行符和双引号等特殊字符。
创建并写入基础 CSV 文件
使用 csv.Writer 将数据逐行写入文件。注意需手动调用 Flush() 确保缓冲区内容落盘。
- 打开文件时用
os.Create(覆盖写)或os.OpenFile(追加写) - 每行数据传入
w.Write([]string{...}),切片元素即各列值 - 写完务必调用
w.Flush()和f.Close(),避免数据丢失
示例:
f, _ := os.Create("data.csv")
w := csv.NewWriter(f)
defer f.Close()
defer w.Flush()
w.Write([]string{"姓名", "年龄", "城市"})
w.Write([]string{"张三", "28", "北京"})
w.Write([]string{"李四", "32", "上海"})
处理含特殊字符的字段(如逗号、换行、双引号)
encoding/csv 默认会自动包裹含逗号、换行符或双引号的字段,并对双引号进行转义(变成两个双引号),无需手动处理。
立即学习“go语言免费学习笔记(深入)”;
- 例如写入
"Alice\nStreet, \"Room 101\"",生成结果为:"AliceStreet, ""Room 101""" - 只要不手动拼接 CSV 字符串,就不用担心格式错误或注入问题
导出带 BOM 的 UTF-8 CSV(适配 Excel 中文乱码)
Windows 上 Excel 默认以 ANSI 打开 CSV,中文易乱码。解决方法是在文件开头写入 UTF-8 BOM(\uFEFF)。
- 在创建
csv.Writer前,先向文件写入[]byte{0xEF, 0xBB, 0xBF} - 之后所有写入操作照常,BOM 仅影响文件头,不影响 CSV 解析逻辑
示例片段:
f, _ := os.Create("export.csv")
f.Write([]byte{0xEF, 0xBB, 0xBF}) // 写入 BOM
w := csv.NewWriter(f)
批量写入结构体数据(提高可读性与复用性)
可将结构体字段映射为 CSV 列,借助反射或手动转换。推荐手动转换——清晰、可控、无依赖。
- 定义结构体,例如
type User { Name string; Age int; City string } - 实现一个
ToCSVRow() []string方法,返回对应字符串切片 - 遍历数据列表,依次调用
w.Write(u.ToCSVRow())
小技巧:若字段较多,可用 fmt.Sprintf 或 strconv 统一转字符串;数字类型建议显式转换,避免意外 panic。










