Go csv.Writer 如何保证导出文件末尾换行一致

做 Go CSV 导出时，最稳妥的办法不是在每个字段后面手动拼 \n，而是让 csv.Writer 统一负责一条记录的结束位置：默认使用 LF，需要兼容明确要求 Windows 行尾的系统时，把 UseCRLF 设为 true。所有记录写完后再调用 Flush，并检查 Writer.Error，这样“最后一行带不带换行”和“最后一批数据是否真正交给底层 writer”就不会混成一个问题。

先固定 CSV 的行终止符规则

csv.Writer 处理的是“记录”，不是一段任意文本。每次调用 Write，它都会把记录中的字段编码后补上一个记录终止符；默认是 LF，也就是字节序列 \n。如果目标系统把 CRLF 视为标准行尾，就在第一次写入前设置 UseCRLF。

字段里的换行是另一件事。比如备注字段本身包含多行文本，csv.Writer 会按 CSV 规则把它放进引号字段中；不要为了“保证末尾换行”把 \n 直接附加到每个字段，否则下游读取到的字段内容也会发生变化。

package main

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

func buildCSV(useCRLF bool) ([]byte, error) {
	var buf bytes.Buffer
	w := csv.NewWriter(&buf)
	// 先固定行尾策略，再写第一条记录，避免同一个文件混用 LF 和 CRLF。
	w.UseCRLF = useCRLF
	records := [][]string{
		{"id", "备注"},
		{"1", "包含换行\n的字段"},
	}
	// WriteAll 会写入每条记录，并在内部调用 Flush；返回值仍要检查。
	if err := w.WriteAll(records); err != nil {
		return nil, fmt.Errorf("写入 CSV 失败: %w", err)
	}
	// Error 用来暴露此前 Write 或 Flush 留下的底层错误。
	if err := w.Error(); err != nil {
		return nil, fmt.Errorf("刷新 CSV 失败: %w", err)
	}
	return buf.Bytes(), nil
}

如果用逐条 Write，就要在循环结束后显式调用 Flush，然后检查 Error。如果使用 WriteAll，它会替你调用 Flush，但仍然应该检查返回值；对于需要把“写入”和“刷新”分开记录的场景，逐条写更容易定位。

Flush 才是最后一批数据的交付边界

csv.Writer 内部有缓冲。前面的 Write 成功，表示记录已经被编码并交给 writer 的缓冲路径，不等于底层文件、网络响应或对象存储已经完成接收。显式 Flush 后，缓冲内容才会被转发给底层 io.Writer。

实际项目里我会把每一层的错误分开收口：记录写入错误直接返回；所有记录写完后调用 Flush；再检查 w.Error()。不要只看最后一次 Write 的结果，也不要把 Flush 成功扩大解释成磁盘 fsync 或业务事务提交成功。

func writeRows(dst io.Writer, rows [][]string, useCRLF bool) error {
	w := csv.NewWriter(dst)
	// 行尾策略必须在第一次 Write 前确定，避免同一份输出出现两种格式。
	w.UseCRLF = useCRLF
	for i, row := range rows {
		// Write 的错误属于当前记录，保留行号方便定位坏数据。
		if err := w.Write(row); err != nil {
			return fmt.Errorf("第 %d 行写入失败: %w", i+1, err)
		}
	}
	// Flush 是把最后一批缓冲数据交给底层 writer 的明确边界。
	w.Flush()
	// csv.Writer 通过 Error 报告 Write 或 Flush 期间保存的错误。
	if err := w.Error(); err != nil {
		return fmt.Errorf("CSV 最终刷新失败: %w", err)
	}
	return nil
}

用字节检查文件末尾，而不是凭肉眼判断

需要和外部系统联调时，可以把输出先写入 bytes.Buffer，在测试中检查最后两个字节。LF 模式的文件末尾应是 0a；CRLF 模式应是 0d 0a。不要把“最后一行显示正常”当作格式证明，很多编辑器会自动隐藏或转换行尾。

如果对方协议反而要求“最后一条记录后不能有换行”，那就不是调整 UseCRLF 能解决的问题。可以先让 csv.Writer 完整生成并成功刷新到内存缓冲区，再在明确的协议层移除最后一个终止符；不要通过修改字段内容破坏 CSV 转义规则。

相关问题

为什么我给字段拼了换行，结果文件出现空行？

因为 csv.Writer 已经会为记录追加行终止符，字段中的换行又会被当作字段内容编码。把字段内容和记录边界分开，删除手工拼接的换行。

只调用 Flush 不检查 Error 可以吗？

不可以。Flush 没有返回值，底层写入失败需要通过 w.Error() 读取；否则程序可能把未完整交付的文件报告成成功。

UseCRLF 要不要默认设为 true？

不要凭平台印象决定。看下游协议或导入器要求；没有特殊约定时保留默认 LF，并在接口文档中写清楚。

参考：Go encoding/csv 官方包文档 与 Go csv.Writer 源码。