Go encoding/csv 怎么保留字段里的换行

CSV 里要保留字段中的换行，关键不是把换行替换成转义字符串，而是把整个字段放进一对双引号。encoding/csv 会把引号内部的物理换行当作字段内容，直到遇到配对的结束引号；因此一条记录可以跨越多行。裸写成 alpha,beta 换行 gamma,delta，才会被当成两条记录。

最小规则：多行字段必须是合法的 quoted-field，例如 "第一行\n第二行"；使用 csv.NewReader 读取时，不要先按行调用 bufio.Scanner 把 CSV 切碎。

确认换行位于引号字段内部

下面的原始数据有三列，第二列故意跨两行。注意第二列从双引号开始，到下一行的双引号结束；中间的换行属于字段值，不是记录结束标记。

name,description,enabled
alpha,"第一行说明
第二行说明",true
beta,单行说明,false

不要先用 Scanner.Scan() 逐行切分，再把每行交给 CSV 解析器。这样第二列会被拆成不完整的片段，后续的引号也失去上下文。正确做法是把完整的 io.Reader 交给 csv.NewReader。

用 csv.Reader 读取并保留字段内容

Reader.Read 每次返回一条完整记录。下面的示例用字符串模拟文件输入，实际项目中把 strings.NewReader 换成打开后的文件即可。

package main

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

func main() {
    input := "name,description,enabled\n" +
        "alpha,\"第一行说明\n第二行说明\",true\n"
    reader := csv.NewReader(strings.NewReader(input))

    for {
        record, err := reader.Read()
        if err == io.EOF { // 读完全部记录后正常结束
            break
        }
        if err != nil { // 解析失败时保留错误上下文
            log.Fatal(err)
        }
        fmt.Printf("字段数=%d，说明=%q\n", len(record), record[1]) // 换行仍在字段值中
    }
}

这里的 record[1] 仍包含一个换行。encoding/csv 默认兼容 RFC 4180 风格的 CSV；输入中的 \r\n 会被统一成 \n，所以业务层不要把 Windows 换行当成另一种字段内容来判断。

按输入边界配置字段数与换行策略

跨行字段和列数检查是两个独立问题。默认情况下，第一条记录决定字段数，后续记录必须一致。固定格式的导入任务可以显式配置，字段数量确实可能变化时才关闭检查。

不要为了“保留换行”就打开 LazyQuotes。合法的引号字段不需要它；过度放宽只会让本应失败的脏数据进入后续业务。

用解析错误定位坏数据

如果字段没有闭合引号，或者引号出现在不允许的位置，Read 会返回解析错误；如果记录列数不符合约束，则常见的是 ErrFieldCount。两类错误的修复方向不同。

record, err := reader.Read()
if err != nil {
    var parseErr *csv.ParseError
    if errors.As(err, &parseErr) { // 取出带行列信息的解析错误
        fmt.Printf("起始行=%d，错误行=%d，列=%d：%v\n",
            parseErr.StartLine, parseErr.Line, parseErr.Column, parseErr.Err)
    } else if errors.Is(err, csv.ErrFieldCount) { // 列数不一致，不等于换行损坏
        fmt.Println("检查字段数量或 FieldsPerRecord 配置")
    }
    return
}
_ = record

需要把错误映射回输入流时，可以在成功读取一条记录后调用 FieldPos 查看某个字段的起始行列，或用 InputOffset 获取当前字节偏移。字段内换行会让物理行号增加，但不会让它自动变成一条新记录。

常见问题

字段里只有换行但没有双引号可以吗？

不可以。CSV 解析器会把字段外的换行视为记录分隔；需要保留换行时，必须使用成对双引号包住字段。

可以先按行读取再拼回 CSV 吗？

不建议。除非你自己实现完整的引号状态机，否则容易在转义双引号、CRLF 和截断输入上出错，直接交给 csv.Reader 更稳妥。

为什么返回的换行不是原始的 CRLF？

Reader 会把输入中的 CRLF 归一化为 LF，包括多行字段内部的 CRLF。这是跨平台读取的一致性处理。

什么时候用 ReadAll？

数据量小且确实需要整体处理时可以用；大文件或导入服务优先循环调用 Read，避免一次性把全部记录放进内存。

因此，解决 Go CSV 换行问题的顺序应当是：先确认数据生产方是否正确引用多行字段，再把完整输入流交给 encoding/csv，最后分别处理列数错误和引号解析错误。官方 API 说明和示例可继续参考 encoding/csv 文档。