用 encoding/csv 读取 CSV 最稳妥,需处理 BOM、显式类型转换、逐行读取并校验错误,写入时设置 Comma 和 UseCRLF 提升兼容性。

直接用 encoding/csv 读取 CSV 是最稳妥的选择
Go 标准库的 encoding/csv 足够健壮,能正确处理带引号、换行符、逗号嵌套等 RFC 4180 兼容格式,不需要额外引入第三方包。关键在于别跳过错误检查,也别假设每行字段数一致。
常见错误现象:csv.Read() 返回 EOF 以外的错误(比如 parse error on line X: bare " in non-quoted-field),往往是因为某行数据格式异常,但程序没做判断就继续读下一行,导致后续解析全乱。
- 始终用
csv.NewReader(file).Read()逐行读,而非一次性ReadAll()—— 大文件容易 OOM - 每行读取后立刻检查
err != nil,特别注意io.EOF是合法终止信号,其他 err 都要处理或记录 - 如果 CSV 有 header,用
reader.Read()先读头,再用reader.FieldsPerRecord = len(header)强制校验后续每行长度
处理含 BOM 的 UTF-8 CSV 文件要手动跳过
Windows Excel 导出的 CSV 经常带 UTF-8 BOM(\uFEFF),而 csv.Reader 不会自动剥离。结果第一列字段名或首行数据开头多出不可见字符,导致 map[string]string 查找失败或 JSON 序列化异常。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 打开文件后,先用
bytes.NewReader(fileBytes)或bufio.NewReader(file)包一层 - 调用
reader.Peek(3)检查是否为[]byte{0xEF, 0xBB, 0xBF},是则reader.Discard(3) - 或者更简单:用
strings.TrimPrefix(string(data), "\uFEFF")预处理原始字节(仅适用于小文件或内存可控场景)
解析时字段类型转换必须显式做,标准库不自动推断
csv.Reader.Read() 只返回 []string,所有数字、布尔、时间都得自己转。常见坑是直接传给 json.Marshal 或数据库驱动,结果存成字符串而非对应类型。
使用场景举例:CSV 中一列是 "2024-03-15",你想转成 time.Time;另一列是 "42",需要转 int64。
- 别用
strconv.Atoi直接转——它对空字符串 panic,而 CSV 空单元格很常见;改用strconv.ParseInt(s, 10, 64)并检查err == nil - 时间解析推荐
time.Parse("2006-01-02", s),但注意空值、格式不统一(如"15/03/2024")需前置清洗 - 布尔字段常见值是
"true"/"false"、"1"/"0"、"yes"/"no",建议封装一个parseBool(s string) (bool, error)统一处理
写入 CSV 时记得设置 Comma 和 UseCRLF
虽然读取通常没问题,但写 CSV 时默认用逗号分隔、LF 换行,这在 Windows 上可能被 Excel 错误识别(尤其含中文时)。导出后双击打开显示所有内容挤在第一列,大概率是换行符或分隔符问题。
性能与兼容性影响:
- 设置
writer.Comma = ';'可适配欧洲地区习惯(Excel 默认用分号分隔) - 设置
writer.UseCRLF = true让每行以\r\n结尾,Excel 在 Windows/macOS 上识别更稳定 - 如果字段含换行符或双引号,
csv.Writer.Write()会自动加引号和转义,无需手动处理 —— 但前提是别提前用fmt.Sprintf拼接字符串










