Go CSV 怎样处理带引号换行字段

Go 处理带引号换行字段时，不要先按 \n 切字符串再拼记录。正确做法是把完整输入交给 encoding/csv.Reader：只要换行位于一对双引号内，它仍属于当前字段，下一条记录会从引号闭合后的换行开始。这个规则同时保留字段中的逗号和转义双引号。

换行必须落在一对双引号内

下面的第三列跨了两行，但它仍然是一条 CSV 记录。字段内部的换行会在返回的字符串中保留为 \n；如果直接按物理行切分，第三列就会被错误拆开，后续列数也会跟着错位。

id,name,remark
1,Go,"第一行说明
第二行说明"
2,Rust,"单行说明"

Go 标准库按 RFC 4180 风格识别 quoted-field。字段开头和结尾的双引号不会出现在结果中，字段内部的逗号可以直接保留；如果内容本身含双引号，CSV 应写成两个连续的双引号。

用 csv.Reader 逐条读取多行记录

读取大文件时使用 Read 循环更容易控制内存和错误位置。示例把字段数量设为 3，并把第三列原样打印出来；代码中的换行来自 CSV 字段本身，不是手工拼接。

package main

import (
	"encoding/csv"
	"errors"
	"fmt"
	"io"
	"strings"
)

func main() {
	input := "id,name,remark\n1,Go,\"第一行说明\n第二行说明\"\n2,Rust,\"单行说明\"\n"
	reader := csv.NewReader(strings.NewReader(input))
	reader.FieldsPerRecord = 3 // 固定三列，避免错位记录悄悄进入业务层

	for {
		record, err := reader.Read()
		if errors.Is(err, io.EOF) { // 正常读完，不把 EOF 当成失败
			break
		}
		if err != nil {
			fmt.Printf("读取失败：%v\\n", err)
			break
		}
		fmt.Printf("id=%s name=%s remark=%q\\n", record[0], record[1], record[2])
	}
}

第二条记录的 remark 会得到包含换行的完整字符串。若改用 ReadAll，解析规则相同，但所有记录都会留在内存中，适合数据量较小且确实需要整体处理的场景。

列数、分隔符和脏数据要显式设边界

FieldsPerRecord 默认值为 0：第一条记录决定后续期望列数。接口输入更建议显式写成正数；如果供应商允许列数变化，才使用负数，并在业务层按字段存在性处理。

换行字段本身不需要打开 LazyQuotes。只要双引号成对出现，标准解析就能处理；贸然开启容错，反而可能把源文件的缺引号问题带到下游。

解析失败时用 ParseError 回到源文件

格式损坏时不要把错误简单转换成“第几条记录失败”。*csv.ParseError 还带有记录起始行、实际错误行和列号；对于跨行字段，这三个位置的差异尤其有用。

var parseErr *csv.ParseError
if err != nil {
	if errors.As(err, &parseErr) { // 保留跨行记录的起始位置，便于定位源文件
		fmt.Printf("记录起始行=%d，错误行=%d，列=%d：%v\\n",
			parseErr.StartLine, parseErr.Line, parseErr.Column, parseErr.Err)
	}
	return err // 让调用方决定跳过、隔离或拒绝这批数据
}

常见错误包括未转义的裸双引号、引号字段没有闭合，以及列数不符合约定。修复顺序应是先确认供应商导出的 CSV 规则，再决定调整 Comma 或兼容策略；不要用正则表达式或字符串替换模拟完整 CSV 解析。

常见问题

带引号换行字段会返回两条记录吗？

不会。只要引号闭合，换行属于当前字段；未闭合的引号才会导致解析错误。

为什么不建议先按换行切分？

因为物理换行和记录换行不是同一概念，字段内部换行只有 CSV 解析器结合引号状态才能正确判断。

什么时候使用 LazyQuotes？

只有在输入格式已知不规范、且业务明确接受宽松解析时使用；正常导出文件应保持默认严格行为。

实际接入时，可以先用固定列数和逐条 Read 建立稳定边界，再根据 ParseError 的位置修正上游数据。这样既能保留备注中的换行，也不会让坏记录悄悄改变后续字段的含义。