Golang解析CSV文件教程

本文深入讲解了 Go 语言标准库 encoding/csv 包在 CSV 文件读写中的核心用法与关键细节，涵盖 UTF-8 编码处理（含 BOM 跳过）、RFC 4180 兼容的引号/换行/逗号字段解析、自定义分隔符与注释行支持、流式读取（Read）与批量加载（ReadAll）的适用场景选择，以及写入时必需的 Flush 操作和中文编码注意事项——无需依赖第三方库，就能安全、高效、灵活地应对从简单表格到复杂业务数据的各种 CSV 处理需求，帮你避开忘记错误处理、编码不一致、缓冲未刷新等高频坑点。

Go 语言内置的 encoding/csv 包提供了简洁、高效、安全的 CSV 解析与生成能力，无需第三方依赖。关键在于正确处理分隔符、引号、换行、编码（如 UTF-8）和错误边界。

读取 CSV 文件（按行解析）

使用 csv.NewReader 包装一个 io.Reader（例如 os.File），然后调用 Read() 或 ReadAll()：

• Read() 每次返回一行（[]string），适合大文件流式处理，避免内存占用过高
• ReadAll() 一次性读取全部内容到内存，适合小文件或需随机访问的场景
• 注意：CSV 文件必须是 UTF-8 编码；若含 BOM，建议先跳过（bytes.TrimPrefix(buf, []byte("\xef\xbb\xbf"))）

处理带引号、逗号、换行的字段

encoding/csv 默认支持 RFC 4180 标准，能自动解析被双引号包裹的字段（如 "Smith, John" 或 "multi
line"）。只需确保：

• 字段分隔符为逗号（可自定义，见下条）
• 引号为双引号 "，且内部双引号需写成两个："He said ""Hi""."
• 每行结尾换行符可以是 \n 或 \r\n，包会自动识别

自定义分隔符与选项

通过设置 csv.Reader 或 csv.Writer 的字段可灵活适配非标准 CSV：

• reader.Comma = '\t' → 解析 TSV（制表符分隔）
• reader.Comment = '#' → 跳过以 # 开头的注释行
• reader.FieldsPerRecord = 5 → 强制每行必须有 5 列，否则报错
• writer.UseCRLF = true → 输出 Windows 风格换行（\r\n）

写入 CSV 文件（生成数据）

用 csv.NewWriter 包装 io.Writer（如 *os.File），再调用 Write() 或 WriteAll()：

• Write([]string{"a", "b,c", "d"}) 会自动转义为 a,"b,c",d
• 记得在写完后调用 writer.Flush()，否则缓冲区内容可能未落盘
• 若需写入 UTF-8 中文，确保输出目标支持（如终端、Excel 需手动指定 UTF-8 编码打开）

基本上就这些。标准库足够覆盖绝大多数 CSV 场景，不复杂但容易忽略细节——比如忘记 Flush、没处理错误、或误把 GBK 文件当 UTF-8 读。

以上就是《Golang解析CSV文件教程》的详细内容，更多关于的资料请关注golang学习网公众号！