Go encoding/csv Writer.UseCRLF 怎样输出 Windows 换行

我在做 CSV 导出时遇到过一个很容易被忽略的差异：文件内容看起来完全正常，但下游 Windows 工具对换行的判断和预期不一致。Go 的 encoding/csv 并不会根据当前操作系统自动选择换行；csv.Writer 默认写入 LF，需要 CRLF 时要显式设置 UseCRLF = true。

官方文档：https://pkg.go.dev/encoding/csv#Writer

把 CSV 输出给依赖 Windows 换行约定的消费方时，在第一次调用 Write 或 WriteAll 前设置 UseCRLF=true；写完后调用 Flush，再检查 Error，这样才能同时处理格式和缓冲输出。

先分清默认 LF 与目标格式

官方文档明确说明，csv.Writer 默认使用 LF，而 UseCRLF 为真时才把每条输出记录的行终止符改成 CRLF。这个字段改变的是记录结束方式，不会改变逗号分隔、引号包裹或字段内容本身。

因此，判断依据应该是下游协议或工具的输入约定，而不是“代码运行在 Windows 上”这一事实。跨平台服务在 Linux 上生成给 Windows 用户下载的 CSV，同样可能需要 CRLF；反过来，已经明确接受 LF 的系统也不必为了平台名称强行改写。

在第一次写入前设置 UseCRLF

Writer 的导出字段应在第一次 Write 或 WriteAll 前完成配置。下面的例子把输出写入文件，并把 CRLF 作为一个明确的消费方契约：

package main

import (
    "encoding/csv"
    "log"
    "os"
)

func exportCSV(path string, records [][]string) error {
    // 创建目标文件；调用方应根据业务决定是否覆盖已有文件。
    file, err := os.Create(path)
    if err != nil {
        return err
    }
    defer file.Close() // 无论中途哪一步失败，都释放文件描述符。

    writer := csv.NewWriter(file)
    writer.UseCRLF = true // 明确要求每条记录使用 Windows 风格的 CRLF。

    for _, record := range records {
        // Write 只负责编码并写入 Writer 的内部缓冲区。
        if err := writer.Write(record); err != nil {
            return err
        }
    }

    writer.Flush() // 将缓冲数据转发到底层文件。
    return writer.Error() // 检查 Write 或 Flush 期间记录的底层错误。
}

func main() {
    // 示例数据包含逗号，csv.Writer 会按 CSV 规则自动引用字段。
    err := exportCSV("report.csv", [][]string{
        {"name", "note"},
        {"Go", "line ending, explicit"},
    })
    if err != nil {
        log.Fatal(err)
    }
}

这里的关键不是把字符串手动拼成 \r\n，而是把换行策略交给 CSV Writer。这样字段中的逗号、双引号和必要的转义仍由同一套编码规则处理，不会因为手工拼接破坏记录结构。

处理 Write、Flush 和 Error 的边界

我更愿意把这三个调用看成三道不同的边界：Write 负责当前记录能否编码，Flush 负责把内部缓冲交给底层 io.Writer，Error 负责读取此前写入或刷新时保存的错误。只检查 Write，可能漏掉最终转发阶段的问题。

如果使用 WriteAll，它会依次写入多条记录并调用 Flush，返回刷新阶段的错误；但在需要逐条统计、记录业务上下文或中途停止时，手动循环更容易把当前记录和最终错误分开处理。

func writeAll(writer *csv.Writer, records [][]string) error {
    // WriteAll 会负责写入全部记录并执行 Flush，适合一次性导出。
    if err := writer.WriteAll(records); err != nil {
        return err
    }
    // 读取 Writer 保存的错误，避免忽略底层 Writer 的失败状态。
    return writer.Error()
}

按消费方选择换行策略

还要注意，UseCRLF 只解决行终止符，不负责字符集转换、BOM、字段类型或 Excel 的业务解释。如果打开文件仍出现乱码或列类型不对，应沿着编码、首行字段和消费方导入设置继续排查，不要把所有问题归到 CRLF。

相关问题

Go csv.Writer 默认是不是 Windows 换行？

不是。默认是 LF；只有显式设置 UseCRLF=true 才使用 CRLF。

设置 UseCRLF 后还要调用 Flush 吗？

要。单条 Write 可能只写入内部缓冲区，完成导出后应调用 Flush 并检查 Error；使用 WriteAll 时它会内部调用 Flush，但仍应处理返回值。

能不能直接给每行字符串拼接换行符？

不建议。手动拼接容易和字段引用、逗号、双引号处理脱节，优先让 encoding/csv 统一编码记录。