Go encoding/csv FieldsPerRecord 遇到可变列数时怎么设置 FieldsPerRecord

导入 CSV 时，如果文件里有的行是 4 列、有的行是 5 列，Go 的 encoding/csv 默认行为很容易让人误判。真正决定是否检查列数的是 csv.Reader.FieldsPerRecord：设为 -1 表示允许每条记录拥有不同数量的字段；设为 0 会以第一条记录的列数为基准；设为正数则强制所有记录匹配该数量。

先分清 FieldsPerRecord 的三种模式

NewReader 返回的 Reader 默认字段值是 0。第一次 Read 后，0 会被替换成首条记录的字段数，后面的记录如果列数变化就会返回 ErrFieldCount。这适合“表头决定格式”的固定 CSV。

如果供应商会在末尾追加可选列，或者同一文件允许明细行和扩展行并存，就不要让第一行决定全文件格式，改用负数关闭列数检查。正数适合契约明确的导入，例如每行必须严格包含订单号、数量、金额和日期四列。

用 -1 读取列数不一致的 CSV

下面的例子允许每条记录列数不同，但只把前两列当作业务必需字段。读取层负责拆分 CSV，业务层负责判断这一行是否足够被处理；这样“列数变化”和“数据损坏”不会混在一起。

package main

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

func main() {
    input := "sku,name,remark\nA-01,键盘\nB-02,鼠标,办公套装\n"
    reader := csv.NewReader(strings.NewReader(input))
    reader.FieldsPerRecord = -1 // 中文注释：允许表头和明细行拥有不同列数

    for {
        record, err := reader.Read()
        if errors.Is(err, io.EOF) {
            break // 中文注释：读完文件后正常结束循环
        }
        if err != nil {
            fmt.Printf("读取失败：%v\n", err) // 中文注释：语法错误仍需单独记录
            continue
        }
        if len(record) 

这里的关键不是“忽略错误”，而是把检查位置后移。-1 只关闭 Reader 的统一列数约束，CSV 引号、换行和分隔符等语法仍由 Reader 处理；商品编号和名称是否存在，则由业务代码决定。

可选列要在业务层做安全归一化

当后续逻辑需要固定结构时，可以先复制必需列，再把缺失的扩展列补成空字符串，或把多出的字段收进一个切片。不要直接假设 record[2] 一定存在，也不要为了凑长度把错误行静默填充后当成完整数据。

如果你最终要写入固定数据库表，建议在这一层生成结构化对象，并明确记录“缺失”“为空”和“额外列”三种状态。这样上游格式变动时，日志仍能说明是哪一类变化。

严格模式下怎样判断 ErrFieldCount

如果选择 0 或正数，Read 在字段数不符合要求时会返回记录和字段数量错误。不要只比较 err == csv.ErrFieldCount；用 errors.Is 可以识别包装在 csv.ParseError 中的底层错误。

record, err := reader.Read()
if err != nil {
    if errors.Is(err, csv.ErrFieldCount) {
        // 中文注释：字段数量异常，record 仍可用于记录行内容或定位
        fmt.Printf("字段数不匹配：%v\n", record)
    } else if errors.Is(err, io.EOF) {
        // 中文注释：EOF 是正常结束信号，不应当记成失败
    } else {
        // 中文注释：其余错误通常需要按 CSV 语法问题继续排查
        fmt.Printf("CSV 解析错误：%v\n", err)
    }
}

实战中可以用 FieldsPerRecord = -1 做兼容性导入，再在业务层统计每种列数；等供应商格式稳定后，改成正数把契约收紧。这个顺序比一开始固定成第一行的列数更适合处理带扩展字段的外部文件。

常见问题

FieldsPerRecord 设为 -1 会不会跳过 CSV 引号错误？

不会。它只关闭字段数量检查，非法引号、分隔符等解析错误仍会返回。

FieldsPerRecord 为 0 能处理可变列吗？

不能。0 会使用第一条记录的字段数作为后续基准，后面的不同列数仍可能触发 ErrFieldCount。

应该用 Read 还是 ReadAll？

大文件或需要逐行处理时用 Read；数据量小且确实要一次归一化全部记录时才考虑 ReadAll，但仍要注意内存占用。