Go csv.Reader FieldPos 怎么定位坏字段

csv.Reader.FieldPos 适合定位“CSV 语法没问题，但某个字段值不合法”的情况。传入最近一次 Read 返回记录中的字段索引，它会给出该字段在原 CSV 中的起始行和列。行、列都从 1 开始，但列是字节位置，不是 Unicode 字符位置。

我会在业务校验失败的当下立刻调用它：不要等到下一次 Read，也不要把不存在的字段索引传进去，否则定位会对应后续记录，索引越界还会直接 panic。

FieldPos 解决的是字段索引到原文位置的映射

以前处理导入错误时，我常给用户返回“第 2 个字段不是整数”。这对开发者够用，对着几十万行 CSV 修改数据的人却不够。FieldPos 的价值不是判断字段对不对，而是把已经发现的问题字段映射回源文件坐标。

reader := csv.NewReader(src)

for {
    record, err := reader.Read()
    if errors.Is(err, io.EOF) {
        break // 文件正常读完
    }
    if err != nil {
        return err // CSV 语法错误交给 ParseError 处理
    }

    const ageIndex = 2
    if ageIndex >= len(record) {
        return fmt.Errorf("字段数量不足") // FieldPos 越界会 panic，先保护索引
    }

    if _, err := strconv.Atoi(record[ageIndex]); err != nil {
        line, column := reader.FieldPos(ageIndex) // 必须针对最近一次 Read 立即调用
        return fmt.Errorf("年龄字段无效：行 %d，字节列 %d", line, column)
    }
}

这里的关键是调用顺序：FieldPos 只记住最近一次 Read 返回记录的字段位置。把错误先存起来、继续读下一行、最后再定位，会拿到错误的记录坐标。

多行字段会让行号和记录行号不同

CSV 的带引号字段可以包含换行。某条记录可能从第 20 行开始，而第三个字段实际从第 22 行开始。FieldPos(2) 返回的是第三个字段起始位置，所以行号可能不是整条记录的起始行。这正是它比手工维护“读到第几条记录”更可靠的地方。

列号也有一个容易忽略的边界：官方定义是按字节计数。英文和 ASCII 标点通常一个字节，中文在 UTF-8 中往往占多个字节。如果要在界面中画字符级光标，不能直接拿 column 当字符数组下标；如果只是回报给日志或数据修复人员，明确写成“字节列”最稳妥。

FieldPos 和 ParseError 不要混用

我会把 CSV 错误分成两类。第一类是解析成功后的业务值错误，例如日期格式不合规、金额无法转换、枚举值不存在；这时字段已经进入 record，适合用 FieldPos。第二类是引号没有闭合、裸引号等 CSV 语法错误；此时应读取 *csv.ParseError 自带的 Line、Column 和 StartLine。

record, err := reader.Read()
if err != nil {
    var parseErr *csv.ParseError
    if errors.As(err, &parseErr) {
        return fmt.Errorf(
            "CSV 解析失败：记录起始行 %d，错误行 %d，字节列 %d：%w",
            parseErr.StartLine,
            parseErr.Line,
            parseErr.Column,
            err, // 保留原错误链，便于上层判断 ErrQuote 等原因
        )
    }
    return err // 非 ParseError 原样上交
}

_ = record // 只有成功返回的字段才适合按索引调用 FieldPos

一个实用的错误对象

生产导入任务里，我更倾向于返回结构化错误，而不是拼一长串文本。这样日志可以输出行列，前端也能单独高亮字段名。

type FieldError struct {
    Name       string
    Value      string
    Line       int
    ByteColumn int
    Err        error
}

func (e *FieldError) Error() string {
    return fmt.Sprintf("%s=%q 位于行 %d、字节列 %d：%v",
        e.Name, e.Value, e.Line, e.ByteColumn, e.Err) // 统一生成可读错误
}

func (e *FieldError) Unwrap() error {
    return e.Err // 保留业务错误链
}

func locateFieldError(r *csv.Reader, record []string, index int, name string, cause error) error {
    if index = len(record) {
        return fmt.Errorf("%s 索引越界：%d", name, index) // 阻止 FieldPos 触发 panic
    }
    line, column := r.FieldPos(index)
    return &FieldError{
        Name:       name,
        Value:      record[index],
        Line:       line,
        ByteColumn: column,
        Err:        cause, // 保存业务校验的真实原因
    }
}

这个错误对象既能输出可读坐标，也能通过 Unwrap 保留底层业务错误。核心原则不变：字段值校验紧跟在 Read 后面，发现错误就立即取位置。

相关问题

FieldPos 的字段编号从 0 还是 1 开始？

参数是 Go 切片索引，所以从 0 开始；返回的行号和列号从 1 开始。这两个基准不要混在一起。

字段数量不对时可以调用 FieldPos 吗？

Read 遇到字段数不符时可能同时返回记录和错误。只有索引确实落在返回的 record 范围内才能调用；否则应直接报告字段数量错误，不能冒险传入越界索引。

怎么获得整条记录结束后的字节偏移？

那是 Reader.InputOffset 的用途。它返回最近读取记录末尾、也就是下一条记录开头的输入流字节偏移；FieldPos 则定位记录内部某个字段的起点。

FieldPos 最适合补齐业务校验的“最后一公里”：先用字段索引确定哪一项不合规，再把它映射到原文件位置。语法错误继续交给 ParseError，两者各司其职，导入错误就能从模糊提示变成可直接修复的坐标。