Golang读取CSV文件方法详解

本文深入解析了 Go 语言中使用标准库 `encoding/csv` 安全、高效读写 CSV 文件的核心实践，强调逐行读取与严格错误处理（尤其区分 `io.EOF` 与其他解析错误）、手动跳过 UTF-8 BOM 以避免字段名污染、显式进行字段类型转换（规避空字符串 panic 和类型误判），以及写入时通过设置 `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 序列化异常。

实操建议：

• 打开文件后，先用 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 拼接字符串

BOM 处理和字段类型转换这两步，最容易在开发后期才暴露问题，尤其是当测试数据干净、上线后用户上传格式混乱的 CSV 时。

终于介绍完啦！小伙伴们，这篇关于《Golang读取CSV文件方法详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！