Go csv.Reader 怎么读取列数不固定的文件

要读取每行列数不固定的 CSV，在第一次调用 Read 前把 reader.FieldsPerRecord 设为 -1。负数表示不检查记录列数，后续每行都会按实际字段数量返回。

但这只取消了解析器的“一致列数”限制，不应该取消业务校验。我的做法是把格式拆成三段：固定的必填前缀、允许缺省的可选字段，以及需要单独保存或限制数量的扩展字段。

默认为什么会出现 ErrFieldCount

FieldsPerRecord 的零值不是“无限制”。它会在第一次 Read 时记住首条记录的字段数，并要求后续记录保持一致。因此第一行有 4 列、第二行有 6 列时，第二次读取就可能返回记录和 ErrFieldCount。

先把 FieldsPerRecord 设为 -1

reader := csv.NewReader(src)
reader.FieldsPerRecord = -1 // 必须在第一次 Read 前关闭固定列数检查

for {
    record, err := reader.Read()
    if errors.Is(err, io.EOF) {
        break // 文件读取完成
    }
    if err != nil {
        return err // 引号等 CSV 语法错误仍需正常处理
    }

    fmt.Printf("本行实际列数：%d\n", len(record)) // 每条记录可以返回不同长度
}

这个设置不会关闭 CSV 引号、分隔符和转义规则。它只是不再比较每条记录的字段数量，所以语法错误仍会按正常方式返回。

宽松读取后仍要做业务校验

我踩过的坑是把 -1 当成“什么数据都能收”。解析虽然通过，后面直接访问 record[2] 仍可能因为缺列而越界。更稳妥的方式是先规定最少列数，再分别读取可选字段。

type Row struct {
    ID      string
    Name    string
    Email   string
    Note    string
    Extras  []string
}

func normalize(record []string) (Row, error) {
    const minFields = 3
    const maxFields = 8

    if len(record)  maxFields {
        return Row{}, fmt.Errorf("最多允许 %d 列，实际 %d 列", maxFields, len(record)) // 阻止异常扩展
    }

    row := Row{
        ID:    record[0],
        Name:  record[1],
        Email: record[2],
    }
    if len(record) >= 4 {
        row.Note = record[3] // 第四列缺失时保留零值
    }
    if len(record) > 4 {
        row.Extras = append([]string(nil), record[4:]...) // 独立保存尾部扩展字段
    }
    return row, nil
}

三种文件结构怎么处理

只有尾部备注列可选

最简单的情况是前几列固定、最后一列可能缺失。设置 -1 后检查最少列数，再用 len(record) 判断可选列是否存在即可。

不同版本追加了新列

可以保留固定前缀，把新列放入 Extras，同时记录文件版本或表头。不要只按“第几个位置”猜含义；版本差异明显时，应先读取表头建立名称到索引的映射。

整行结构完全不确定

如果每行代表不同记录类型，建议让第一列携带类型标识，再按类型分派到不同解析函数。单纯允许任意列数只解决读取问题，不能替代数据协议。

func parseByKind(record []string) (any, error) {
    if len(record) == 0 {
        return nil, fmt.Errorf("空记录") // 没有类型标识时无法分派
    }

    switch record[0] {
    case "user":
        return parseUser(record) // 用户记录使用自己的最小列数
    case "order":
        return parseOrder(record) // 订单记录使用另一套结构
    default:
        return nil, fmt.Errorf("未知记录类型：%s", record[0])
    }
}

常见误区

把 FieldsPerRecord 设为 0 能允许变长吗？

不能。0 会让 Reader 以第一条记录的列数作为后续期望值；真正关闭检查要使用负数。

出现 ErrFieldCount 后 record 还能用吗？

官方说明 Read 在列数不符合预期时会同时返回记录和错误。是否继续使用应由业务决定；如果文件本来就允许变长，更清晰的办法是在读取前设为 -1，然后自行校验。

可以直接把短记录补空字符串吗？

可以，但要明确哪些列允许缺省。对必填列盲目补空值会掩盖源数据问题；建议只对声明为可选的尾部字段补默认值。

读取列数不固定的 CSV，配置只占一行：FieldsPerRecord = -1。真正决定质量的是后续边界设计——固定前缀保证必填信息，可选字段显式补值，扩展字段限制上限并保留含义。这样既能兼容变长文件，也不会让异常数据悄悄进入系统。