Go csv.Reader 怎样读取分号分隔的 CSV 文件

如果 CSV 文件使用分号而不是逗号分隔，Go 的 encoding/csv 不需要换库：创建 csv.Reader 后，在第一次调用 Read 或 ReadAll 之前把 Comma 设置为 ';' 即可。关键是先改字段分隔符，再开始读取；不要把分号当成普通字符串清洗，也不要在读取一部分记录后再修改配置。

官方文档：https://pkg.go.dev/encoding/csv

分号 CSV 的最小写法是 reader := csv.NewReader(source) 后追加 reader.Comma = ';'。Comma 必须是合法 rune，不能是回车、换行或 Unicode 替换字符；如果还配置了 Comment，两者也不能相同。

先把字段边界交给 Reader

csv.NewReader 默认按逗号切字段，所以同一行 id;name;role 会被当成一个字段。分号文件应在读取前改写 Comma，引号字段里的分号仍会被当作字段内容，而不是新的分隔符。

package main

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

func main() {
    input := "id;name;role\n1;Alice;reviewer\n2;Bob;owner\n"
    reader := csv.NewReader(strings.NewReader(input))
    reader.Comma = ';' // 先声明字段分隔符，再调用 Read。

    for {
        record, err := reader.Read()
        if err == io.EOF { // EOF 只表示记录读取完毕，不是失败。
            break
        }
        if err != nil {
            log.Fatal(err) // 解析错误要停止，避免继续使用不完整记录。
        }
        fmt.Printf("%s -> %s\n", record[0], record[1])
    }
}

这个示例中每行会得到三个字段。若字段值本身包含分号，应使用 CSV 的双引号规则，例如 2;"研发;平台";owner，而不是再写一个字符串替换函数。

配置合法性和修改时机要一起看

Comma 的类型是 rune，适合表示一个字段分隔字符。它不能设置为 \r、\n 或 utf8.RuneError；非法值会让后续读取进入错误路径。实际项目中通常在构造 Reader 后立即完成配置，再把 Reader 交给业务函数。

reader := csv.NewReader(source)
reader.Comma = ';'       // 分号文件的字段分隔符。
reader.Comment = '#'     // 注释行以 # 开头，不能与 Comma 相同。
reader.FieldsPerRecord = 3 // 固定三列时，让 Reader 主动发现坏行。

records, err := reader.ReadAll() // 配置完成后一次性读取剩余记录。
if err != nil {
    // ReadAll 返回的错误需要保留给调用方，不要静默丢弃。
    return err
}

如果列数可能变化，可以把 FieldsPerRecord 设为负数，再由业务代码按表头或最小列数自行判断。默认值为零时，第一条记录的列数会成为后续记录的期望列数；这正是很多“第一行能读、第二行报错”的来源。

把 EOF、字段数量错误和语法错误分开

循环读取时只把 io.EOF 当作正常结束。列数不符合约定时，Read 会返回记录和字段数量错误；引号不闭合、裸引号等格式问题则属于解析错误。需要给用户提示时，可以通过 errors.As 取出 csv.ParseError 的行号和字节列号。

record, err := reader.Read()
if err != nil {
    if err == io.EOF { // 没有更多记录，退出循环即可。
        return nil
    }

    var parseErr *csv.ParseError
    if errors.As(err, &parseErr) {
        // ParseError 的行列信息适合写入导入失败提示。
        return fmt.Errorf("第 %d 行第 %d 字节解析失败: %w", parseErr.Line, parseErr.Column, err)
    }
    return fmt.Errorf("读取 CSV 失败: %w", err)
}
_ = record // 这里交给后续业务校验和保存。

上面的片段若单独放进文件，还需要在 import 中加入 errors 和 fmt。示例重点是错误分类：不要因为看到部分字段就忽略后续的解析错误，也不要把 EOF 记录成失败。

常见误区与速查

• 只改输入字符串：把分号替换成逗号可能破坏引号字段，应该直接设置 Comma。
• 配置太晚：在首次 Read 后再改字段，会让同一个 Reader 的解释规则不一致。
• 忽略固定列数：固定格式导入建议显式设置 FieldsPerRecord，让坏行尽早暴露。
• 把 ReadAll 当成无错误：它会读到 EOF，但仍会返回字段数量错误或解析错误。

归纳起来，分号 CSV 的处理只有一个核心动作：在读取开始前设置 Reader.Comma。接下来根据文件是否固定列数选择 FieldsPerRecord，并用 io.EOF、csv.ParseError 和普通错误分别处理结束、格式问题与其它 I/O 失败。

相关问题

Reader.Comma 能设置成多个字符吗？不能，它是一个 rune，一次只能表示一个字段分隔字符；多字符分隔格式需要先定义明确的解析协议。

分号出现在双引号字段里会被拆开吗？不会。符合 CSV 引号规则时，双引号内的分号属于字段内容。

为什么配置 Comment 后出现字段缺失？只有行首且前面没有空白的 Comment 字符才会整行忽略；带前导空白时，它仍可能成为字段内容。