Golang读取CSV及encoding/csv使用教程

本文深入讲解了 Go 语言中使用标准库 `encoding/csv` 包高效、安全地读取 CSV 文件的最佳实践，涵盖文件打开、编码处理、分隔符自定义等基础配置，并重点介绍了逐行解析（适用于大文件）、跳过表头并构建字段映射、以及将 CSV 行解析为结构体三种主流场景，同时强调其对引号、转义、换行等复杂格式的原生支持，远胜于手动字符串分割，是 Golang 开发者处理 CSV 数据值得信赖的权威指南。

在 Go 中读取 CSV 文件，最标准、最可靠的方式是使用标准库中的 encoding/csv 包。它能正确处理带引号、换行符、逗号转义等复杂 CSV 场景，比手动字符串分割安全得多。

打开文件并创建 CSV reader

先用 os.Open 打开文件，再将文件句柄传给 csv.NewReader。注意检查错误，尤其是文件不存在或权限不足的情况。

• 确保文件路径正确，推荐使用绝对路径或基于当前工作目录的相对路径
• 如果 CSV 使用非 UTF-8 编码（如 GBK），需先用 golang.org/x/text/encoding 转码，encoding/csv 本身只支持 UTF-8
• 可选：调用 reader.Comma = ';' 改为分号分隔（兼容某些欧洲格式）

逐行读取记录（推荐用于大文件）

对多数场景，尤其文件较大时，应使用 Read() 循环读取每一行，避免一次性加载全部内容到内存。

• 每次调用 r.Read() 返回一个 []string，每个元素对应一列的值（已自动去除引号、还原转义）
• 遇到空行会返回 nil, nil；遇到 EOF 会返回 nil, io.EOF；解析出错则返回具体错误（如列数不一致）
• 建议在外层用 for 循环配合 err == nil 判断，而非仅检查 err == io.EOF

跳过表头并映射字段名

若 CSV 含表头（第一行为字段名），可先读一次获取 header，后续每行用 map[string]string 关联字段名与值。

• 调用一次 r.Read() 获取 header 切片，例如 []string{"name", "age", "city"}
• 后续每行读出后，用 for i, v := range record { m[header[i]] = v } 构建映射
• 注意字段名大小写和空格——CSV 表头常含多余空格，可用 strings.TrimSpace 预处理

解析为结构体（适合固定格式）

若每行语义明确且结构稳定，定义 struct 并手动赋值更清晰、类型安全。标准库不直接支持 tag 映射（如 csv:"name"），需自行桥接。

• 先读 header，建立列名 → struct 字段索引的映射（如 map[string]int{"name": 0, "age": 1}）
• 读每行时，按索引取值并转换类型：age, _ := strconv.Atoi(record[idx["age"]])
• 可封装为通用函数，传入 struct 类型和 header，利用反射自动绑定（但小项目中直接手写更轻量、易调试）

到这里，我们也就讲完了《Golang读取CSV及encoding/csv使用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！