我在接收带备注字段的 CSV 时遇到过一个很容易误判的现象：一条记录的备注里有换行，肉眼看像是多行，结果却不应该被拆成多条记录。Go 不需要先手动拼接这些行，encoding/csv.Reader 会根据引号状态识别记录边界。
官方地址：https://pkg.go.dev/encoding/csv
只要换行位于成对双引号包住的字段内，就应当作为字段内容保留；真正的记录边界是字段已经闭合后的换行。标准 CSV 优先保持默认严格解析，只有确实要兼容历史脏数据时才打开容错参数。
为什么引号里的换行仍然属于同一条记录
CSV 的关键不是“每遇到换行就切一行”，而是 Reader 是否仍处于一个带引号字段中。下面的输入包含两条记录，第一条的第二个字段跨了两行：
id,remark
1001,"第一行备注
第二行备注"
1002,"没有跨行"
第一条记录的字段值会是 第一行备注\n第二行备注，而不是拆出一个只有 第二行备注 的新记录。逗号仍然负责分隔字段，成对双引号负责界定可以包含逗号和换行的字段。
用 Reader 逐条读取并保留换行
实际代码应把文件交给 csv.NewReader，再循环调用 Read。Reader 会跨物理行收集一个完整记录，调用方只需要按返回的字段处理业务：
package main
import (
"encoding/csv"
"errors"
"fmt"
"io"
"os"
)
func main() {
file, err := os.Open("notes.csv")
if err != nil {
// 文件打不开时无法判断任何记录，直接结束当前任务。
panic(err)
}
defer file.Close() // 读取结束后及时释放文件描述符。
reader := csv.NewReader(file)
reader.FieldsPerRecord = 2 // 固定两列，避免列数漂移被静默接收。
for {
record, err := reader.Read()
if errors.Is(err, io.EOF) {
// EOF 表示没有下一条记录，不是解析失败。
break
}
if err != nil {
// ParseError 中包含行列位置，适合记录后回看原始文件。
fmt.Printf("读取 CSV 失败：%v\n", err)
break
}
// record[1] 保留引号字段中的换行，可按原样交给业务层。
fmt.Printf("id=%s，备注=%q\n", record[0], record[1])
}
}
这里没有调用 ReadAll，因此文件很大时仍能保持逐条处理。FieldsPerRecord = 2 是一个有意的约束：首行是表头且业务跳过表头时，应把它放在读取逻辑中处理，不能让表头列数和数据列数的差异造成误判。
Reader 参数怎样配合错误处理
默认 Reader 期待符合 RFC 4180 习惯的 CSV。这个默认值更适合新生成的文件；从旧系统迁移时，再根据真实输入调整参数：
FieldsPerRecord = 0会用第一条记录的字段数作为后续基准；设为正数可固定列数，设为负数则允许每条记录列数不同。LazyQuotes = true允许未加引号字段中出现引号，或带引号字段中出现没有成对转义的引号。它能救回一部分脏数据，但也会降低格式错误的暴露速度。- 如果分隔符不是逗号，修改
Comma；如果首字符表示注释，再配置Comment。不要为了“保留换行”打开与问题无关的宽松选项。
读取错误时要区分三种情况：io.EOF 是正常结束；字段数量不一致通常是 ErrFieldCount；引号没有闭合或格式破坏则通常会得到 ParseError。不要只判断错误字符串中是否包含“换行”，否则会把真正的格式问题误当成正常的多行字段。
迁移时最容易踩的三个坑
- 先用 strings.Split 拆行。这会在 Reader 看到引号状态前破坏输入，应该直接把原始
io.Reader交给csv.NewReader。 - 把 LazyQuotes 当成默认修复开关。它只适合已知存在非标准输入的迁移场景。开启后应把来源、容错原因和后续清洗计划写进配置说明。
- 用 ReadAll 处理未知大小文件。多行字段本身不是内存问题，整份文件一次载入才可能造成峰值；持续调用
Read更容易控制处理节奏。
如果业务最终要把备注写入数据库，建议在 CSV 层保留原始换行，展示层再决定是否折叠。这样既不会丢失原始信息，也不会把“显示成一行”和“解析成一条记录”混为一谈。
相关问题
CSV 字段里有逗号也要加双引号吗？
要。逗号、换行或双引号出现在字段内容中时，应使用符合 CSV 规则的引号包住字段；字段内部的双引号通常写成两个双引号。
怎样判断一条记录是否真的结束？
不要自行按物理行判断。让 Reader.Read 返回记录；返回成功代表一条完整记录，返回 io.EOF 才代表输入结束。
