Go encoding/csv 如何读取带换行的引号字段

导入 CSV 时，最容易误判的一种情况是：某个备注字段本身包含换行，程序却把它当成了下一条记录。Go 的 encoding/csv 已经处理了这个边界：只要换行位于成对双引号内部，它就是字段内容；只有引号结构不完整时，Read 才会返回解析错误。

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

先确认换行属于引号字段而不是新记录

CSV 的换行是否结束一条记录，取决于它是否已经离开 quoted-field。下面这一行虽然跨了两行文本，但第二列从双引号开始，到下一行的双引号才结束，因此仍然只有一条记录。字段里的逗号也遵循同一规则，不会额外切列。

id,note
1,"第一行
第二行"
2,普通文本

读取后，第一条记录的结果相当于 []string{"1", "第一行\n第二行"}。开头和结尾的引号不会进入字段值；字段内要表达一个双引号，则使用连续的两个双引号，例如 "他说 ""可以"""。

用 Reader.Read 按记录读取多行 CSV

实际处理时建议使用循环调用 Read，让读取器自行跨越字段内部的换行。若文件结构稳定，可以把 FieldsPerRecord 设为明确列数；设为 0 时，第一条记录的列数会成为后续记录的默认约束。

package main

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

func main() {
	// 用原始字符串保留 CSV 中的真实换行，第二列仍是一个字段。
	input := "id,note\n1,\"第一行\n第二行\"\n2,普通文本\n"
	reader := csv.NewReader(strings.NewReader(input))
	// 这里明确要求每条记录都有两列，避免脏数据静默进入后续流程。
	reader.FieldsPerRecord = 2

	for {
		record, err := reader.Read()
		if errors.Is(err, io.EOF) {
			// EOF 表示已经读完，不是 CSV 格式错误。
			break
		}
		if err != nil {
			// 其他错误交给统一的导入错误处理，不继续使用半条记录。
			fmt.Printf("读取失败：%v\n", err)
			return
		}
		fmt.Printf("列数=%d，备注=%q\n", len(record), record[1])
	}
}

这个循环的关键不是把输入先按换行切开，而是把记录边界交给 Reader。如果手工先调用 strings.Split(input, "\n")，字段内部的换行就会被提前破坏，后面再也无法恢复原记录。

用 ParseError 定位引号和字段结构错误

当输入少了结束引号，错误信息不应只记一行“解析失败”。*csv.ParseError 提供记录起始行、实际出错行和列号；它还会通过 Unwrap 暴露底层的 ErrQuote、ErrBareQuote 或 ErrFieldCount，适合用 errors.As 和 errors.Is 分层判断。

var parseErr *csv.ParseError
if errors.As(err, &parseErr) {
	// ParseError 的行列号适合写入导入日志，便于回到原文件定位。
	fmt.Printf("记录起始行=%d，错误行=%d，列=%d，原因=%v\n",
		parseErr.StartLine, parseErr.Line, parseErr.Column, parseErr.Err)
	if errors.Is(err, csv.ErrFieldCount) {
		// 字段数问题和引号语法问题的修复路径不同。
		fmt.Println("请检查列数或 FieldsPerRecord 配置")
	}
}

注意，跨行字段的 StartLine 与错误发生的 Line 可能不同，这正是它比简单打印物理行更有价值的地方。Go 的读取器还会把输入中的 \r\n 规范化为 \n，因此业务层得到的多行字段不会因为 Windows 或 Unix 换行习惯不同而改变。

按数据来源选择严格模式或宽松模式

如果 CSV 来自可控的导出程序，优先保持默认引号规则，并固定 FieldsPerRecord。这样列数变化会尽早暴露。只有在确认上游确实产生了非 RFC 4180 风格的裸引号时，才考虑 LazyQuotes；它会放宽校验，但也可能把原本应该修复的脏数据带进系统。

可以把策略记成三句话：字段内换行交给 Reader，列数约束交给 FieldsPerRecord，源文件格式错误交给 ParseError。不要用关闭错误检查或把所有错误都当 EOF 的方式“修复”导入。

相关问题

字段里有逗号时也必须加双引号吗？

是。逗号出现在字段值中时，应把整个字段放入双引号；读取器会把它作为字段内容而不是分隔符。

为什么设置 FieldsPerRecord 后突然报错？

因为读取器开始检查每条记录的列数。先确认是否误把表头、空列或导出端的可选列混在同一文件中，再决定固定列数还是显式使用负数放开检查。

LazyQuotes 能解决缺少结束引号吗？

它只放宽部分引号规则，不能替代格式修复。若数据可控，应保留严格模式并让 ParseError 暴露源文件问题。