如何在 Go 中使用 encoding/csv.NewWriter 自定义 CSV 输出-Golang-PHP中文网

encoding/csv.newwriter默认不写bom且不统一换行符，需手动写\ufeff并控制usecrlf；字段含特殊字符时自动转义，但必须调用flush()确保落盘。

如何在 go 中使用 encoding/csv.newwriter 自定义 csv 输出

为什么 `encoding/csv.NewWriter` 写出的 CSV 没有 BOM 或换行混乱

Go 标准库的 csv.Writer 默认不写 BOM，且对换行符（\r\n vs \n）完全依赖底层 io.Writer 的行为。如果你用 os.Stdout 或 bytes.Buffer 直接传给 NewWriter，输出在 Windows 上可能被 Excel 识别为乱码，或在某些解析器里因换行不一致而截断。

csv.Writer 本身不处理文本编码，只负责按 RFC 4180 转义字段、拼接逗号和换行
它写入的是纯 []byte，不会自动加 UTF-8 BOM（\xEF\xBB\xBF）
换行符由你传入的 io.Writer 决定：比如 os.Stdout 在 Windows 下通常用 \r\n，但 bytes.Buffer 只写 \n

要控制 BOM 和换行风格，必须在外层包装写入目标：

buf := &bytes.Buffer{}
// 先写 BOM（仅当需要 UTF-8 + Excel 兼容时）
buf.Write([]byte("\xEF\xBB\xBF"))
w := csv.NewWriter(buf)
// 后续 WriteAll / Write 都追加到 buf 中
w.WriteAll(data)
w.Flush() // 必须调用，否则缓冲区内容不写出

`csv.Writer.Comma` 和 `csv.Writer.UseCRLF` 怎么影响输出格式

Comma 控制分隔符，默认是 ,；设为 '\t' 就变成 TSV。这个字段必须在第一次 Write 前设置，改了也没用。

UseCRLF 是 Go 1.22+ 新增字段（之前没有），启用后会让 Write 内部用 \r\n 替代 \n 作为记录分隔符。但它不改变字段内换行——字段里若含 \n，仍会被引号包裹并保留原样。

w.Comma = ';' → 输出用分号分隔，Excel 打开需手动指定分隔符
w.UseCRLF = true → 每条记录末尾写 \r\n，适合 Windows 环境或老系统解析器
二者可共存：w.Comma = '\t'; w.UseCRLF = true → 制表符分隔 + CRLF 结束

注意：UseCRLF 对 WriteAll 生效，但如果你自己拼字符串再 WriteString，它不管。

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

如何安全写入含中文、换行、逗号的字段

csv.Writer 会自动处理这些：只要字段含 Comma、"、\r、\n 中任意一个，就用双引号包裹；字段内双引号会被转义为 ""。

但有三个易错点：

字段是 nil 或空字符串 "" 时，Write 会输出空字段（即两个逗号之间啥也没有），不是 " " 或 "null"
如果字段是 "a\nb"，输出为 "a\nb"（带引号和原换行），不是 "a<lf>b"</lf>；接收方必须支持跨行字段
不要提前手动加引号或转义——csv.Writer 会覆盖你的操作，导致双引号嵌套错误，例如 "\"hello\"" 最终变成 ""hello""

正确做法就是原样传：

data := [][]string{
    {"张三", "研发部", "2023-01-01"},
    {"李四", "测试部\n含换行", "2023-02-15"},
    {"王五", "销售,含逗号", "2023-03-22"},
}
w.WriteAll(data) // 全部自动转义，无需干预