Go encoding/csv 中带引号换行的字段怎么解析

CSV 里最容易误判的一种数据，是字段值本身包含换行，例如备注字段写成了两行。只要这个字段被一对双引号完整包住，换行就属于字段内容，不是新记录的开始。Go 的 encoding/csv 已经处理了这条边界，正确做法是把输入交给 csv.Reader，不要先用 strings.Split 按物理换行切开。

不要按换行切字符串：csv.Reader 会跨行读取带引号字段

下面这段输入有三条记录。第二条的备注字段从第一行的引号开始，下一行才结束；其中的逗号也属于备注内容：

id,name,note
1001,仓库一,"第一行备注
第二行备注，仍然属于同一个字段"
1002,仓库二,正常备注

如果先调用 strings.Split(input, "\n")，第二条记录会被拆成两个字符串，后面的逗号数量也就失去意义。CSV 的记录边界必须由引号状态和分隔符共同判断，这正是 csv.Reader 的职责。

用 Read 按完整记录解析，并保留错误边界

逐条读取时，循环只把 io.EOF 当作正常结束；其他错误要保留下来。示例中的 ParseError 能告诉我们记录起始行、出错行和列位置，适合把坏数据交给日志或人工修复。

package main

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

func main() {
    input := "id,name,note\n1001,仓库一,\"第一行备注\n第二行备注，仍然属于同一个字段\"\n1002,仓库二,正常备注\n"
    reader := csv.NewReader(strings.NewReader(input))
    reader.FieldsPerRecord = 3 // 固定三列，提前发现列数漂移

    for {
        record, err := reader.Read()
        if errors.Is(err, io.EOF) {
            break // 输入正常结束，不把 EOF 当成失败
        }
        if err != nil {
            var parseErr *csv.ParseError
            if errors.As(err, &parseErr) {
                fmt.Printf("CSV 解析失败：起始行=%d，错误行=%d，列=%d，原因=%v\n",
                    parseErr.StartLine, parseErr.Line, parseErr.Column, parseErr.Err)
            } else {
                fmt.Printf("CSV 读取失败：%v\n", err)
            }
            continue // 坏记录交给上层处理，不继续使用不完整字段
        }

        line, column := reader.FieldPos(0) // 定位当前记录第一个字段
        fmt.Printf("位置=%d:%d，字段=%q\n", line, column, record)
    }
}

这里的关键不是把换行替换为空格，而是让 Reader 先完成 CSV 语法解析。返回的 record 中，note 仍是一个字符串，只是字符串内部保留了换行。若上游业务不允许换行，可以在解析完成后再做字段级清洗。

逐条读取时，字段数和解析错误要分开处理

FieldsPerRecord 和引号语法是两类约束。前者回答“这一条有几列”，后者回答“字段边界是否合法”。不要看到任何错误都把它归为“换行导致”。固定字段数时，正数表示严格要求列数；设为负数才表示允许每条记录有不同列数。

需要注意的是，FieldPos 针对最近一次 Read 返回的记录，字段下标从 0 开始；传入越界下标会触发 panic，因此调用前应先确认 len(record)。

Read 和 ReadAll 怎么选

文件较大或输入来自网络时，优先使用 Read，处理一条就交给下游，内存占用更可控。数据很小、确实需要整体排序或批量校验时，可以使用 ReadAll；它会持续读取到 EOF，并把所有记录放进二维切片。

如果分隔符不是逗号，应在第一次读取前设置 reader.Comma；如果业务允许未加引号的异常引号，再考虑 LazyQuotes，不要为了“读进去”而默认打开它。宽松解析可能掩盖上游导出错误。

常见问题

带引号的字段里有逗号，需要额外转义吗？

符合 CSV 规则时，逗号放在引号字段内部即可，csv.Reader 会把它保留为字段内容。

字段中出现双引号怎么写？

在 quoted-field 内用两个连续的双引号表示一个双引号，例如 "他说 ""可以"""。

能不能先按行读取，再拼回跨行字段？

不建议。这样需要自己维护引号状态、转义和错误行号，容易在逗号或异常引号处产生二次错误；直接使用 csv.Reader 更稳妥。

所以，Go 解析带引号换行的 CSV 字段时，边界原则只有一句：先让 encoding/csv 识别完整记录，再在业务层处理字段内容。这样换行、逗号、字段数和错误定位各自有清晰职责，后续接数据库或消息队列也更容易保持数据完整。