Go encoding/csv.Reader 怎样跳过空记录

如果你只是想跳过 CSV 文件中的空行，encoding/csv.Reader 已经会忽略真正的空行；但一行空格、一个空字段，或者一行写成 ""，仍可能被读成记录。更稳妥的做法是：让 Reader 负责 CSV 语法，再用一个明确的业务规则判断“这一整条记录是否为空”。

本文采用的规则是：所有字段经过 strings.TrimSpace 后都为空，才跳过整条记录；像 id,,name 这样的记录仍然保留，因为它包含有效字段。

Reader 先过滤什么，业务代码再过滤什么

标准库把物理空行和 CSV 解析交给 Reader。真正的空行不会进入后面的 Read 结果，但只含空格或制表符的行有字段内容，不能把它们和空行混为一谈。设置 Comment 后，指定字符开头的整行也会被 Reader 忽略；这和“业务上的空记录”是两层规则。

因此不要先用 bufio.Scanner 按行切开再手工 strings.Split。CSV 字段可能包含逗号、引号甚至换行，手工切行很容易把一个合法字段拆坏。

用 allFieldsBlank 定义“空记录”

过滤函数最好独立出来，这样产品可以在“只认空字符串”和“空白也算空”之间切换，也不会把字段数量判断、错误处理和业务入库混在一起。

package main

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

// allFieldsBlank 只把整条记录为空的情况交给过滤逻辑。
// 因为它逐字段判断，所以 id,,name 仍会保留，不会误删中间空字段。
func allFieldsBlank(record []string) bool {
    if len(record) == 0 {
        return true
    }
    for _, field := range record {
        if strings.TrimSpace(field) != "" {
            return false
        }
    }
    return true
}

// readNonBlankRecords 负责读取 CSV；真正的业务处理应放在 yield 回调中。
// FieldsPerRecord=-1 表示允许每条记录字段数不同，避免输入不齐时提前报错。
func readNonBlankRecords(r *csv.Reader, yield func([]string) error) error {
    r.FieldsPerRecord = -1 // 先关闭固定列数约束，本文只关注空记录过滤

    for {
        record, err := r.Read()
        if errors.Is(err, io.EOF) {
            return nil // 正常读完文件，不把 EOF 当成失败
        }
        if err != nil {
            return fmt.Errorf("读取 CSV 失败：%w", err) // 保留行号等解析错误信息
        }
        if allFieldsBlank(record) {
            continue // 跳过空白记录，但不跳过含有效字段的记录
        }
        if err := yield(record); err != nil {
            return fmt.Errorf("处理 CSV 记录失败：%w", err) // 业务错误立即向上返回
        }
    }
}

这里的关键不是 continue 本身，而是过滤条件的边界。Read 返回的切片只代表一条已经按 CSV 语法解析好的记录；allFieldsBlank 再决定这条记录是否有业务价值。

空字段和空记录不是一回事

以下几种输入看起来都“空”，但业务含义不同：

如果空字符串本身是合法业务值，例如“匿名用户”用一行空值表示，那么不要直接复用本文规则。可以把判断改成“字段数为 1 且字段为空才跳过”，或在解析后根据表头和业务主键判断。

读取循环中的三个边界

第一，io.EOF 是文件正常结束，不应该作为错误日志输出。第二，解析错误要保留原始错误，因为标准库的错误里可能带有行号和字段位置。第三，FieldsPerRecord 默认会根据第一条记录建立字段数约束；如果你的文件允许变长记录，应像示例一样显式设置为 -1，否则问题会在空记录处理之前就结束。

如果 CSV 使用注释行，可以在创建 Reader 后设置 r.Comment = '#'，但注释字符必须满足标准库约束；不要在过滤函数里把所有以某个字符开头的字段都当成注释，否则会误删合法数据。

常见问题

为什么空行已经没了，空格行还在？

因为标准库区分“没有字段的空行”和“字段内容由空白组成的记录”。需要业务层再做 TrimSpace 判断。

为什么不能用 len(record) == 0 判断？

CSV Reader 通常会返回包含字段的切片，即使字段内容为空。判断整条记录要遍历字段，而不是只看切片长度。

怎样保留空字段但跳过空记录？

使用“所有字段都为空才跳过”的谓词。只要有一个字段非空，整条记录就保留，正好覆盖 id,,name 这类输入。

总结：让 csv.Reader 处理 CSV 语法，把“空记录”的定义留在一个小函数中。这样空行、空白行、空字段和注释行各自有清晰边界，后续更换输入规则时也只需调整一处。