Go CSV Reader FieldsPerRecord 设置为负数代表什么

如果 CSV 的每一行不一定拥有相同列数，Go 的 encoding/csv 可以把 Reader.FieldsPerRecord 设为负数。它的含义很明确：读取时不检查每条记录的字段数量，因此变长记录不会因为列数不同触发 csv: wrong number of fields。这个设置只放宽“字段数量”这一项，引号、分隔符和格式错误仍然会照常检查。

FieldsPerRecord 为负数到底改变了什么

csv.NewReader 默认把 FieldsPerRecord 设为 0。第一次成功读取后，Reader 会把第一条记录的字段数作为后续记录的期望值；例如表头有 3 列，第四列缺失或多出一列，后续 Read 就可能返回 csv.ErrFieldCount。

设置为负数后，这条“列数必须一致”的约束被关闭。下面的配置关系最容易记：

变长 CSV 应该怎样读取

负数模式下，业务代码要把“是否有足够的字段”从 CSV 解析器手里接过来。比如订单明细至少需要订单号、商品名和数量三列，后面的扩展信息可以不存在：

package main

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

func main() {
    input := "order_id,item,quantity,remark\nA100,键盘,2\nA101,鼠标,1,仓库补发\n"
    reader := csv.NewReader(strings.NewReader(input))
    // 负数表示允许每条记录拥有不同数量的字段。
    reader.FieldsPerRecord = -1

    for row := 1; ; row++ {
        record, err := reader.Read()
        if errors.Is(err, io.EOF) {
            break
        }
        if err != nil {
            // 引号错误、非法记录等解析错误不能靠负数配置屏蔽。
            fmt.Printf("第%d行解析失败：%v\n", row, err)
            continue
        }
        if len(record) = 4 {
            remark = record[3]
        }
        fmt.Printf("订单=%s 商品=%s 数量=%s 备注=%s\n",
            record[0], record[1], record[2], remark)
    }
}

这段代码的关键不是把校验全部删掉，而是把校验拆成两层：CSV 解析器继续负责语法，业务代码负责必需列和可选列。这样既能接受第三方文件偶尔多一列，也不会因为缺少核心字段而把错误数据继续写入数据库。

什么时候不该直接设成负数

如果文件本来就是固定协议，例如每行都必须是“用户编号、姓名、状态”三列，负数会让格式问题变得不明显。此时可以保留默认的 0，或者显式设置为 3，让错误尽早暴露。

还要注意，FieldsPerRecord=-1 不会改变 CSV 的其他规则。带引号的逗号仍属于字段内容，未闭合引号仍可能返回解析错误；字段数放宽后，len(record) 反而更值得记录到日志中，方便定位来源文件的格式漂移。

常见问题

FieldsPerRecord 设置为 -1 后还会返回 ErrFieldCount 吗？

正常情况下不会，因为字段数检查被关闭了。但其他解析错误仍可能返回；如果业务代码自己检查列数，也可能主动返回业务错误。

FieldsPerRecord 设置为 0 和 -1 有什么区别？

0 会在第一条记录后锁定字段数，后续记录必须一致；-1 始终允许不同记录拥有不同字段数。

使用负数后能不能直接按 record[3] 取值？

不能。变长记录可能只有三列，访问不存在的下标会触发 panic。先检查 len(record)，再读取可选字段。

因此，遇到字段数不一致时，先判断这是合法的变长数据还是输入文件损坏：前者用负数并保留业务层最低列数检查，后者继续使用固定字段数约束。