17370845950

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 默认会自动包裹含逗号、换行符或双引号的字段，并对双引号进行转义（变成两个双引号），无需手动处理。

• 例如写入 "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。