如何在Golang中使用encoding/csv读写CSV文件_解析表格数据

go标准库encoding/csv提供高效CSV读写能力，支持自动引号处理、bom清理及结构体映射；需注意分隔符设置、Flush调用时机与字段类型限制。

Go 语言标准库 encoding/csv 提供了简洁、高效、内存友好的 CSV 读写能力，无需第三方依赖即可处理常见表格数据。关键在于理解 csv.Reader 和 csv.Writer 的行为，尤其是字段分隔、引号处理、换行与编码等细节。

读取 CSV 文件：逐行解析为字符串切片

使用 csv.NewReader 包装一个 io.Reader（如 *os.File），然后调用 Read() 逐行获取 []String。默认以逗号分隔，自动处理带引号的字段（含逗号、换行、双引号）。

• 每行返回一个字符串切片，对应一列；空行返回 []string{}，不是 nil
• 遇到格式错误（如引号不匹配）会返回 csv.ParseError，应检查并处理
• 若首行为表头，建议先 Read() 一次保存为 headers，后续行用 map[string]string 映射字段

写入 CSV 文件：按行写入字符串切片

用 csv.NewWriter 包装 io.Writer（如 *os.File），再调用 Write() 写入 []string。写完必须调用 Flush() 确保数据落盘。

• 字段含逗号、换行符或双引号时，Write() 自动添加双引号并转义内部双引号（变成两个双引号）
• 不支持直接设置分隔符为制表符等其他字符——需创建自定义 csv.Writer 并设置 Comma 字段
• 避免在循环中反复 Write() 后立即 Flush()，会影响性能；应在批量写完后统一 Flush()

处理带 BOM 的 UTF-8 文件

windows 记事本保存的 CSV 常含 UTF-8 BOM（xEFxBBxBF），Go 默认不识别，会导致首列字段开头出现乱码。解决方法是在打开文件后，用 bytes.TrimPrefix 剥离 BOM：

因赛AIGC

因赛AIGC解决营销全链路应用场景

280

查看详情

立即学习“go语言免费学习笔记（深入）”；

• 读文件时，先 io.ReadAll 或用 bufio.Reader 读前几个字节判断是否含 BOM
• 若存在，跳过 BOM 再传给 csv.NewReader；或用 strings.Reader 包装清理后的字节
• 写入时一般无需加 BOM，除非明确要求兼容某些旧软件（此时在写入前手动写入 BOM 字节）

结构体与 CSV 的双向映射（简易版）

标准库不提供自动结构体绑定，但可通过反射 + 标签实现轻量映射。例如定义结构体字段加 csv:"name" 标签，读时用 reflect 按标签名匹配表头，写时按顺序提取字段值。

• 读取时：先读表头 → 构建字段名到结构体字段索引的映射 → 每行按映射填充结构体
• 写入时：用 reflect.Value 遍历结构体字段，按预设顺序生成 []string 再写入
• 注意导出字段（首字母大写）、类型兼容性（只支持 string / int / Float / bool 等基础类型转字符串）