Golang如何读取CSV文件详解

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《Golang读取CSV文件方法解析》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

Go 中读取 CSV 文件最标准方式是使用 encoding/csv 包，需用 os.Open 打开文件并创建 csv.Reader，支持自动处理引号、转义和换行；推荐逐行 Read() 解析，可跳过表头、映射字段名或解析为结构体。

在 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文件详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！