当前位置：首页 > 文章列表 > Golang > Go问答 > Go encoding/csv CSV 中字段数量不一致时怎样保留坏行

Go encoding/csv CSV 中字段数量不一致时怎样保留坏行

来源：17golang原创 2026-10-24 17:29:40 0浏览收藏

导入 CSV 时，最容易误判的一类错误是 record on line n: wrong number of fields。这不代表整份文件不可读：encoding/csv 的 Reader.Read 会把当前记录和字段数错误一起返回。做法是先保存返回的 record，再判断 err，把坏行放进隔离集合，正常行继续交给业务处理。

官方文档：https://pkg.go.dev/encoding/csv@go1.27.3#Reader

要点速览

FieldsPerRecord=0 会用首条记录建立字段数基线。
字段少或多时，Read 仍返回当前 record，同时返回 csv.ErrFieldCount。
引号等语法错误要通过 csv.ParseError 记录位置，不能把部分字段当成完整业务数据。

FieldsPerRecord 如何建立字段数基线

Reader 有三种策略。正数表示每条记录必须有指定数量的字段；零值会在第一次成功读到记录时采用它的字段数；负数则完全关闭字段数量检查。导入有固定列定义时，通常保留零值，让表头或第一条数据建立基线；如果第一行是表头，也要确认它确实和后续数据列数一致。

FieldsPerRecord	行为	适合场景
正数	严格要求固定字段数	已知格式、希望配置显式化
0	首条记录决定后续字段数	常规 CSV 导入
负数	允许每行字段数不同	确实是可变列的文件

Go encoding/csv Reader 用首条记录建立 FieldsPerRecord 字段数基线并返回 ErrFieldCount 的结构说明图 — 图1：字段数基线说明图，展示 Reader 如何保留字段数量异常的记录。

在 Read 循环里先保存坏行

不要写成“只要 err != nil 就跳过”。io.EOF 才表示读取结束；字段数异常和部分解析错误都可能带着可用的 record 返回。下面的代码把正常行和坏行分开保存，并为每条坏行附上偏移和解析位置。

package main

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

type badRow struct {
    Fields []string
    Line   int
    Column int
    Offset int64
    Err    error
}

func collectCSV(input string) ([][]string, []badRow, error) {
    reader := csv.NewReader(strings.NewReader(input))
    // 让首条记录确定字段数，后续少列或多列记录进入坏行集合。
    reader.FieldsPerRecord = 0

    var valid [][]string
    var badRows []badRow
    for {
        record, err := reader.Read()
        if err == io.EOF {
            break
        }

        // 默认不启用 ReuseRecord；复制一份也能明确隔离坏行的生命周期。
        fields := append([]string(nil), record...)
        item := badRow{Fields: fields, Offset: reader.InputOffset(), Err: err}
        var parseErr *csv.ParseError
        if errors.As(err, &parseErr) {
            item.Line = parseErr.Line
            item.Column = parseErr.Column
        }

        if err != nil {
            // 字段数量错误可留存后继续；其他解析错误也先隔离并记录。
            badRows = append(badRows, item)
            continue
        }
        valid = append(valid, fields)
    }
    return valid, badRows, nil
}

func main() {
    // 第二条少一列，第三条多一列；两条都会被保留。
    input := "id,name,score\\n1,Ada,98\\n2,Bob\\n3,Cyd,87,extra\\n"
    valid, badRows, err := collectCSV(input)
    if err != nil {
        panic(err)
    }
    fmt.Printf("valid=%d bad=%d\\n", len(valid), len(badRows))
}

这里用 errors.As 取出 ParseError，是因为字段数错误也会被包装在解析错误结构中；用 errors.Is(err, csv.ErrFieldCount) 可以进一步只识别字段数量异常。生产代码可以把 badRows 序列化到隔离文件，供人工修复，而不是把它们悄悄丢掉。