Go标准库encoding/csv提供轻量高效CSV读写能力,支持自定义分隔符、流式处理、错误定位及结构体手动映射,无需第三方依赖。

Go 语言标准库 encoding/csv 提供了轻量、高效、无依赖的 CSV 读写能力,适合处理结构清晰的表格数据(如导出报表、配置导入、日志分析等),无需第三方包即可完成基础操作。
读取 CSV 文件:逐行解析为字符串切片
使用 csv.NewReader 包装 *os.File 或任意 io.Reader,调用 Read() 逐行获取 []string。每行对应一行记录,每个字符串对应一个字段(已自动处理引号、逗号转义)。
- 默认以逗号分隔,支持自定义分隔符(如制表符
\t)通过reader.Comma = '\t' - 首行不自动跳过,需手动调用一次
Read()忽略表头(若存在) - 遇到格式错误(如引号不匹配)会返回
csv.ParseError,建议用errors.Is(err, csv.ErrFieldCount)等判断具体类型
读取 CSV 并映射到结构体:手动解析 + 类型转换
encoding/csv 不提供自动结构体绑定(类似 Python 的 DictReader),需手动将字符串切片转为结构体字段。推荐方式:
- 先读取表头行,建立列名到结构体字段索引的映射(如
map[string]int{"name": 0, "age": 1}) - 后续每行用该映射取值,再用
strconv.Atoi、time.Parse等转为目标类型 - 可封装为通用函数,配合 struct tag(如
csv:"name")提升可维护性(需额外反射逻辑)
写入 CSV 文件:按行写入字符串切片
用 csv.NewWriter 包装 io.Writer(如 *os.File),调用 Write([]string) 写入一行,最后必须调用 writer.Flush() 确保数据落盘。
立即学习“go语言免费学习笔记(深入)”;
- 写入内容会自动加引号(如含逗号、换行符或开头结尾空格的字段)
- 可通过
writer.UseCRLF = true在 Windows 下使用\r\n换行(默认为\n) - 写入前建议检查字段中是否含非法字符(如 \x00),避免解析失败
处理大文件与内存优化:流式读写 + 错误恢复
对大 CSV(GB 级),避免一次性加载全部数据:
- 用
for循环 +reader.Read()流式处理,每行处理完即释放内存 - 写入时复用同一
[]string切片(预分配容量),减少 GC 压力 - 读取出错时,可用
reader.InputOffset()获取当前字节偏移,辅助定位问题行 - 关键业务建议加日志记录失败行号和原始内容,便于人工核查










