Go csv.FieldsPerRecord 设为零为什么仍可能报错

结论先说：FieldsPerRecord = 0 不是“允许每行列数不同”，而是让 encoding/csv.Reader 用第一条记录的字段数作为后续标准。第一行有 3 列、第二行只有 2 列时，第二次读取仍会返回 csv.ErrFieldCount。如果文件本来就允许变长记录，应把它设为负数。

我第一次遇到这个问题时，也把零值理解成了“关闭校验”。真正容易误判的地方是：零值只是在读取第一条记录前暂时没有标准，一旦第一条记录读完，标准就被确定了。

零值真正做了什么

csv.NewReader 创建的 Reader 默认把 FieldsPerRecord 设为 0。官方定义可以浓缩为三种情况：

最小示例：0 和 -1 的区别

下面的数据第一行 3 列，第二行 2 列。保持零值时，第二条记录会触发字段数错误：

package main

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

func main() {
    input := "name,city,age\nAlice,Shanghai\n"
    r := csv.NewReader(strings.NewReader(input))
    r.FieldsPerRecord = 0 // 用首条记录的 3 列作为后续标准

    for {
        record, err := r.Read()
        if errors.Is(err, io.EOF) {
            break
        }
        if errors.Is(err, csv.ErrFieldCount) {
            // Read 会同时返回已经解析出的记录，便于定位或决定是否容错
            fmt.Printf("列数不一致：%v\n", record)
            continue
        }
        if err != nil {
            // 其他解析错误不能当成普通列数变化忽略
            fmt.Printf("CSV 解析失败：%v\n", err)
            break
        }
        fmt.Println(record)
    }
}

如果业务定义明确允许每行字段数不同，只改一处即可：

r := csv.NewReader(strings.NewReader(input))
r.FieldsPerRecord = -1 // 负数才表示不做字段数量检查

这里有个实用细节：Read 遇到字段数不符时，会返回当前记录和错误，而不是只给一个空结果。导入系统可以据此记录原始行、补默认值或放入人工处理队列，但不要在不了解业务含义时静默补列。

为什么改成负数仍可能失败

FieldsPerRecord 只控制“字段数量是否一致”，不会关闭 CSV 语法解析。裸引号、缺失闭合引号等输入仍可能返回 *csv.ParseError。同理，分隔符设置错误、读取底层 I/O 失败，也不是把字段数设为负数就能解决的。

排查时可以先判断错误类型：

var parseErr *csv.ParseError
switch {
case errors.Is(err, csv.ErrFieldCount):
    // 字段数量与当前策略不一致，检查 0、正数或负数是否选对
case errors.As(err, &parseErr):
    // 使用 ParseError 的行、列信息定位引号等格式问题
    fmt.Printf("第 %d 行、第 %d 列解析失败：%v\n", parseErr.Line, parseErr.Column, parseErr.Err)
case err != nil:
    // 保留底层 I/O 等其他错误，不要统一吞掉
    fmt.Printf("读取失败：%v\n", err)
}

生产代码应该选哪个值

对我来说，最稳妥的选择不是一律设成 -1，而是先确认数据契约：

• 有表头且数据行必须与表头一致：保留 0，或者读取表头后显式写入它的长度。
• 协议规定固定列数：设为对应正数，让错误尽早暴露。
• 每行本来就是不同记录类型：设为负数，并在业务层按记录类型检查必需字段。
• 只是偶发缺列：不要直接关闭校验，应记录行号、原始记录和错误原因。

因此，标题里的“设为零仍报错”其实是符合设计的行为。零值代表自动建立字段数约束，负数才代表取消这个约束；即便取消，CSV 的引号和分隔语法仍然必须合法。

相关问题

FieldsPerRecord 为 0 时，空白行会成为第一条记录吗？

不会。encoding/csv 会忽略空白行，第一条实际返回的记录才用于确定字段数。

设置 LazyQuotes 能解决 ErrFieldCount 吗？

不能直接解决。LazyQuotes 放宽的是引号规则，ErrFieldCount 由字段数量策略决定，两者是不同边界。