Go csv.Writer 怎么导出兼容 Windows 的 CRLF 文件

如果 CSV 导出文件在某些 Windows 工具里换行显示异常，先看记录终止符，而不是先改字段内容。Go 的 encoding/csv.Writer 默认使用 LF；面向明确依赖 CRLF 的消费端时，在第一次写入前设置 UseCRLF = true，每条记录就会以 \r\n 结束。写完后还要调用 Flush，再读取 Error 判断底层输出是否成功。

官方地址：https://pkg.go.dev/encoding/csv#Writer

最小改动就是 w := csv.NewWriter(dst) 后设置 w.UseCRLF = true。它只改变 CSV 记录的换行写出方式，不负责编码转换，也不替你决定字段如何转义。

先把默认换行和 CRLF 目标分开

csv.NewWriter 创建的 Writer 默认把记录结尾写成 \n。这对许多 Unix 工具没有问题，但如果下游系统把 CRLF 作为文件格式约定，就应该显式打开 UseCRLF。这个开关针对的是记录终止符，不是把所有输入字符串做一次全局换行替换。

还有一个容易混淆的边界：字段本身可以包含换行。CSV Writer 会按 CSV 规则为这类字段加引号，并根据 UseCRLF 写出字段内的换行表示；它并不等于把字段中的文字内容改成另一种编码。本文只讨论换行格式兼容，不展开字段转义规则。

在第一次写入前设置 UseCRLF

把配置放在所有 Write 或 WriteAll 之前，能让导出函数的写出策略一眼可见。下面用 bytes.Buffer 表示任意实现了 io.Writer 的目标；这是示例结构，不把未执行的输出伪装成终端结果。

package export

import (
    "bytes"
    "encoding/csv"
    "fmt"
    "io"
)

// WriteWindowsCSV 将记录写成以 CRLF 结尾的 CSV 数据。
func WriteWindowsCSV(dst io.Writer, records [][]string) error {
    if dst == nil {
        return fmt.Errorf("输出目标为空")
    }

    w := csv.NewWriter(dst)
    // 必须在第一次 Write 或 WriteAll 前设置，记录结尾才使用 CRLF。
    w.UseCRLF = true

    for _, record := range records {
        // Write 只负责把当前记录放入 Writer 的缓冲区。
        if err := w.Write(record); err != nil {
            return fmt.Errorf("写入 CSV 记录失败: %w", err)
        }
    }

    // Flush 把 Writer 内部缓冲区转交给底层输出目标。
    w.Flush()
    // Error 能报告 Write 或 Flush 期间记录下来的底层错误。
    if err := w.Error(); err != nil {
        return fmt.Errorf("刷新 CSV 输出失败: %w", err)
    }
    return nil
}

func sample() ([]byte, error) {
    var buf bytes.Buffer
    records := [][]string{
        {"name", "region"},
        {"Alice", "Windows"},
    }
    // bytes.Buffer 只是演示目标；生产环境可换成文件或网络输出。
    if err := WriteWindowsCSV(&buf, records); err != nil {
        return nil, err
    }
    return buf.Bytes(), nil
}

这个函数把“写入记录”和“最终输出成功”分成两个判断。若只检查 Write 返回值而不 Flush，数据可能还停留在缓冲区；若 Flush 后不检查 Error，底层文件或网络写失败就可能被忽略。

Flush 和 Error 要一起成为发布检查

Writer.Write 的写入是有缓冲的。完成所有记录后调用一次 Flush 即可把剩余内容交给底层 io.Writer；如果只在中途 Flush，不会改变已经设置好的 UseCRLF，但会增加调用复杂度。更适合导出任务的写法，是在函数收尾统一刷出并读取错误。

如果使用 WriteAll，它会连续写入记录并负责 Flush，返回 Flush 阶段的错误；此时仍应直接处理它的返回值。不要把 WriteAll 后再调用一次 Flush 当成错误修复手段，重复刷出通常只是冗余。

// WriteAllCRLF 适合已经准备好全部记录的一次性导出。
func WriteAllCRLF(dst io.Writer, records [][]string) error {
    if dst == nil {
        return fmt.Errorf("输出目标为空")
    }
    w := csv.NewWriter(dst)
    // 配置必须先于 WriteAll，避免首批记录使用默认换行。
    w.UseCRLF = true
    if err := w.WriteAll(records); err != nil {
        // WriteAll 已经包含刷出动作，这里直接保留底层错误。
        return fmt.Errorf("批量导出失败: %w", err)
    }
    return nil
}

生产环境的换行兼容清单

在发布一个需要给 Windows 工具消费的 CSV 文件时，可以把下面几项写进导出函数的检查清单：

• 目标明确要求 CRLF 时，创建 Writer 后立即设置 UseCRLF = true。
• 不要用字符串全局替换代替 Writer 的格式化逻辑，尤其不要破坏字段内换行和 CSV 引号边界。
• 逐条 Write 的模式最后统一 Flush 并检查 Error；WriteAll 则处理它的返回错误。
• 把文件换行兼容与字符编码转换分开验收；UseCRLF 不会把 UTF-8 自动变成其他编码。
• 如果下游仍显示异常，先确认它的实际格式要求，再排查传输或打开工具是否改写了换行。

几个容易混淆的问题

UseCRLF 要在每次 Write 前设置吗？

不需要。创建 Writer 后、第一次写入前设置一次即可；不要在已经写出部分记录后临时切换，以免一个文件内部出现不同的记录终止符。

Flush 成功就代表文件一定完整吗？

Flush 只负责把缓冲数据交给底层 Writer。仍要检查 Error，并由更外层负责文件关闭、重命名或提交等生命周期动作。

UseCRLF 能解决中文乱码吗？

不能。它只处理换行终止符；中文显示问题属于字符编码或打开工具的识别范围，应单独设计和处理。

参考资料：https://pkg.go.dev/encoding/csv#Writer、https://go.dev/src/encoding/csv/writer.go。示例只展示接口职责和错误处理边界。