Go encoding/csv Reader.Comma 怎样读取制表符分隔文件

Go 的 encoding/csv 默认按逗号拆分字段。遇到 TSV 或其他制表符分隔文本时，不需要自己先按行切字符串，只要在第一次调用 Read 或 ReadAll 前把 Reader.Comma 设置为 '\t' 即可。关键是确认输入里的是真正的制表符，而不是若干个普通空格。

官方资料：https://pkg.go.dev/encoding/csv

先确认 Comma 决定的是字段边界

csv.NewReader 创建的 Reader 初始使用逗号作为分隔符，Comma 是一个 rune 字段，表示每个字段之间的边界字符。制表符文件应配置为 '\t'；如果文件实际使用分号、竖线或逗号，就必须与输入契约保持一致。

设置完成后，带引号的字段仍按 CSV 规则处理。引号内的制表符属于字段内容，不会被再次拆开；字段外的制表符才会产生新的字段。解析器还会把空白视为字段内容，不能把视觉上相邻的空格误认为一个制表符。

在第一次 Read 前设置 Reader.Comma

Reader 的可导出配置应在第一次读取前完成。下面的例子把一段 TSV 文本交给 Reader，逐条读取并区分正常记录、结束信号和解析错误：

package main

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

func main() {
	input := "name\tage\tnote\nAda\t37\t\"Go\\t入门\"\n"
	reader := csv.NewReader(strings.NewReader(input))
	reader.Comma = '\t' // 指定制表符为字段分隔符，必须在第一次 Read 前设置

	for {
		record, err := reader.Read()
		if errors.Is(err, io.EOF) { // 读完全部记录后，EOF 是正常结束信号
			break
		}
		if err != nil { // 保留解析错误，避免把坏数据当成完整记录使用
			fmt.Printf("读取失败：%v\n", err)
			break
		}
		fmt.Printf("字段数=%d，记录=%v\n", len(record), record)
	}
}

示例中第二条记录的备注字段用引号包住，其中的制表符属于字段内容。这里的 Comma 只是告诉 Reader 如何找字段边界，不会替你判断文件是否真的采用 TSV 格式。

空白、引号和非法分隔符怎么判断

遇到结果列数不对时，优先检查这三件事：

• 分隔符是否一致：输入可能混用了制表符和空格；普通空格不会因为 Comma='\t' 自动变成列边界。
• 引号是否成对：引号字段可以包含分隔符，但未闭合或未转义的引号可能返回 ParseError。
• Comma 是否有效：它必须是有效 rune，不能是回车、换行或 Unicode replacement character；也不能与 Comment 相同。

如果要忽略行首注释，还可以设置 Comment，但注释符不能与制表符相同。若字段数必须固定，可配置正数的 FieldsPerRecord；这属于列数策略，和选择制表符分隔符是两个独立问题。

Read 与 ReadAll 的收尾方式

文件较大时使用 Read 循环可以控制内存，并在每条记录处处理错误；数据量明确且适合一次放入内存时才使用 ReadAll。ReadAll 成功返回时错误值是 nil，不会把读到文件末尾的 io.EOF 当作错误。

func readTSV(input string) ([][]string, error) {
	reader := csv.NewReader(strings.NewReader(input))
	reader.Comma = '\t' // 先固定输入协议，再一次性读取剩余记录
	reader.FieldsPerRecord = -1 // 允许示例数据列数变化；生产环境按业务契约决定是否开启

	records, err := reader.ReadAll()
	if err != nil { // ReadAll 会返回具体的解析错误，不要只检查 records 是否为空
		return nil, err
	}
	return records, nil
}

排查清单

1. 确认分隔符是实际的制表符，而不是多个空格。
2. 确认 reader.Comma = '\t' 写在第一次读取之前。
3. 检查包含制表符或引号的字段是否按 CSV 引号规则编码。
4. 根据文件规模选择逐条 Read 或集中式 ReadAll，并保留错误处理。

常见问题

把 Comma 设置为普通空格可以读取空格分隔文件吗？

可以设置为有效的空格 rune，但它会把每一个空格视为分隔符，连续空格也不会自动压缩成一个。若输入是按任意空白分列的文本，应先明确数据协议，再选择专门的解析方式。

设置 Comma 后为什么仍然只有一列？

最常见原因是输入并非真正的制表符，或者设置发生在第一次 Read 之后。先检查原始字节和配置时机，再判断是否存在引号包裹的整行字段。

简要结论：TSV 读取的核心是 csv.NewReader 后、第一次读取前设置 Comma = '\t'；字段内容中的引号和制表符仍遵循 CSV 解析规则，错误则应交给 Read 或 ReadAll 返回值处理。