Go encoding/csv FieldsPerRecord 设置为负数后如何自行校验列数

导入 CSV 时，最容易混淆的是“文件能被解析”和“记录符合业务格式”并不是一回事。FieldsPerRecord 设置为负数后，encoding/csv.Reader 会允许每条记录拥有不同数量的字段；它只关闭列数检查，不会关闭引号、分隔符和换行的语法解析。正确做法是先宽松读出记录，再在业务层校验必填列和可接受的最大列数。

需要兼容变长 CSV 时使用 FieldsPerRecord = -1，随后用 len(record) 自行校验结构；解析错误仍按 error 单独处理，不能把负数理解为“任何内容都能读”。

官方文档：https://pkg.go.dev/encoding/csv

一、先把 FieldsPerRecord 的三种语义分清

这个字段不是“是否校验”的简单开关，而是三种数据契约。正数表示每条记录都必须有指定数量的字段；零值表示第一条有效记录决定后续基准；负数表示 Reader 不比较各条记录的列数。无论取哪种值，CSV 的引号闭合、分隔符和多行字段仍由 Reader 负责解析。

二、宽松读取不等于跳过 CSV 语法错误

把值改成负数后，列数不一致的记录会正常返回，但格式损坏依然会报错。例如未闭合引号、字段中的裸引号等问题属于解析错误，应该保留错误位置并停止或隔离当前文件。Read 在遇到解析失败时可能返回部分记录，因此不要在 err != nil 时继续把这条记录映射到结构体。

三、用 len(record) 把业务列数校验接回来

下面的示例假定订单 CSV 至少有 4 列，最多允许 6 列；第 5、6 列是可选扩展字段。校验逻辑只关心结构正确的记录，且先验证长度再访问下标，这样缺列会变成可读的业务错误，而不是数组越界。

package main

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

func readOrders(input string) error {
    reader := csv.NewReader(strings.NewReader(input))
    // 允许可选尾列；CSV 的引号和分隔符语法仍由 Reader 解析。
    reader.FieldsPerRecord = -1

    logicalRow := 0
    for {
        record, err := reader.Read()
        if err == io.EOF {
            break
        }
        logicalRow++
        if err != nil {
            var parseErr *csv.ParseError
            // 语法错误与业务列数错误分开，便于定位原始文件。
            if errors.As(err, &parseErr) {
                return fmt.Errorf("CSV 第 %d 条记录解析失败：%w", logicalRow, err)
            }
            return fmt.Errorf("CSV 第 %d 条记录读取失败：%w", logicalRow, err)
        }
        if len(record)  6 {
            // 先校验长度，避免下面的下标访问触发 panic。
            return fmt.Errorf("CSV 第 %d 条记录列数为 %d，要求 4 到 6 列", logicalRow, len(record))
        }

        orderID, customerID, amount, currency := record[0], record[1], record[2], record[3]
        // 通过校验后再映射核心字段；可选列按长度决定是否读取。
        note := ""
        if len(record) >= 5 {
            note = record[4]
        }
        fmt.Println(orderID, customerID, amount, currency, note)
    }
    return nil
}

func main() {
    // 第 2 条记录多一个备注列，属于允许的变长记录。
    input := "order_id,customer_id,amount,currency\nA-1,C-9,12.5,CNY\nA-2,C-8,8.0,CNY,加急\n"
    if err := readOrders(input); err != nil {
        fmt.Println(err)
    }
}

这里的 logicalRow 是逻辑记录序号；如果 CSV 字段包含换行，它和物理行号可能不同。需要定位字段起点时，可以在最近一次成功 Read 后使用 FieldPos，但调用前必须确保字段索引在记录范围内。

四、校验通过后再决定如何处理额外字段

“允许变长”仍然要有边界。只允许可选尾列时可以采用最小列数加最大列数；如果尾列是动态属性，则把剩余部分复制到单独切片或按表头映射，避免静默丢失数据。对导入任务而言，缺少核心列通常应拒绝当前记录；多出未知列则可按兼容策略记录告警后继续，但这个选择要写进数据契约。

如果格式本来就固定，不建议为了少写一段校验而使用负数。稳定导出文件可设置正数，让 Reader 直接返回 ErrFieldCount；只有“可选列确实存在”或“要兼容多个历史宽度”时，负数才表达了真实意图。

常见问题

FieldsPerRecord=-1 会不会忽略 CSV 格式错误？

不会。它只关闭字段数量比较，未闭合引号等解析错误仍由 Read 返回。

为什么不用 FieldsPerRecord=0？

零值会把首条记录的列数作为后续基准，适合“首行是什么宽度，后面都必须一样”的文件，不适合可选尾列。

Read 返回错误时还能使用 record 吗？

解析错误时可能只有部分字段，不能把它当作完整业务记录；应记录错误位置并按策略跳过或终止。

什么时候应该直接拒绝额外列？

当额外列可能代表错位、版本不兼容或敏感数据时，应设置明确的最大列数并拒绝，避免静默接收错误输入。