最稳妥方式是每次writer.Write()后检查writer.Error()并适时Flush；需手动写BOM头解决Excel中文乱码；结构体须转字符串切片，字段顺序须与表头严格一致。
用 csv.Writer 写入单行数据最稳妥
Go 标准库的 encoding/csv 包不支持直接写入“一行一记录”的快捷方法，必须显式调用 writer.Write()。常见错误是误以为 Write() 会自动换行或追加列分隔符——它只负责把切片元素按逗号拼接并写入底层 io.Writer，换行需手动触发。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 始终在每次
writer.Write()后调用writer.Flush()或writer.Error()检查写入是否成功，否则缓冲区可能滞留数据 - 字段含逗号、换行符或双引号时，
csv.Writer会自动加双引号并转义，无需手动处理 - 避免直接传入
nil切片，会 panic；空行应传[]string{}
file, _ := os.Create("data.csv")
writer := csv.NewWriter(file)
defer writer.Flush()
writer.Write([]string{"name", "age"}) // 表头
writer.Write([]string{"Alice", "30"})
writer.Write([]string{"Bob", "25"})
批量写入多行要控制缓冲与错误检查
高频调用 Write() 时，性能瓶颈常在系统 I/O 和频繁 flush。但过度依赖缓冲又会导致错误定位困难——比如第 1000 行出错，writer.Error() 只返回最后一次失败原因，无法追溯哪一行触发了问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 每写入 100–1000 行后主动
writer.Flush()，平衡性能与可观测性 - 不要只靠
defer writer.Flush()收尾，它无法捕获中间写入失败（如磁盘满） - 对每行调用
writer.Write()后立即检查writer.Error()，而非等全部写完再查
处理中文、特殊字符和 BOM 头
Go 的 csv.Writer 默认输出 UTF-8 编码，但 Windows Excel 打开中文 CSV 常显示乱码，本质是缺少 UTF-8 BOM 头。标准库不提供 BOM 写入能力，必须手动前置写入。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 若目标用户主要用 Excel，创建文件后先写入
[]byte{0xEF, 0xBB, 0xBF}，再初始化csv.Writer - 字段含制表符、回车符（
\t、\r\n）会被自动包裹双引号，行为符合 RFC 4180，无需额外过滤 - 避免用
strings.ReplaceAll()预处理换行符——这会破坏原始语义，且 Writer 已内置处理逻辑
file, _ := os.Create("chinese.csv")
file.Write([]byte{0xEF, 0xBB, 0xBF}) // BOM
writer := csv.NewWriter(file)
写入结构体数据需先转换为字符串切片
Go 没有像 Python 的 DictWriter 那样原生支持结构体映射到 CSV 字段。常见错误是试图直接 writer.Write(&myStruct)，这会写入内存地址或 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用反射或代码生成工具（如
go-csv第三方库）自动提取字段值，但小项目更推荐手写转换函数，清晰可控 - 注意导出字段（首字母大写）才可被反射读取；非导出字段会被忽略
- 时间类型字段建议统一转为
time.Format("2006-01-02")等固定格式，避免写入String()的默认长格式
