首页 > Golang > Go教程

GolangCSV读写教程及代码示例

时间：2025-12-23 20:17:39 345浏览收藏

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

Go语言通过encoding/csv标准库提供CSV读写支持：Read()逐行解析为字符串切片，Write()配合Flush()写入，支持自定义分隔符和UTF-8编码，结构体映射需手动对齐表头。

如何使用Golang处理CSV文件_Golang encoding CSV读写示例

Go 语言通过标准库 encoding/csv 提供了简洁、高效的 CSV 文件读写支持，无需第三方依赖，适合处理结构化表格数据。

读取 CSV 文件（按行解析）

使用 csv.NewReader 从文件或任意 io.Reader 中逐行读取，返回字符串切片（每行一列）。

打开文件后传入 os.File 创建 reader
调用 Read() 一次读一行，返回 []string 和错误
注意首行可能是表头，可单独读取后跳过

示例：

file, _ := os.Open("data.csv")
defer file.Close()
reader := csv.NewReader(file)
headers, _ := reader.Read() // 读表头
for {
  record, err := reader.Read()
  if err == io.EOF { break }
  if err != nil { log.Fatal(err) }
  fmt.Println(record) // 如 ["Alice", "28", "Beijing"]
}

写入 CSV 文件（按行输出）

用 csv.NewWriter 包装 io.Writer（如文件），调用 Write() 写入一行，最后别忘 Flush()。

每一行是 []string，自动处理含逗号、换行、引号的字段（内部转义）
WriteAll() 可一次性写多行，更简洁
务必调用 w.Flush() 确保数据真正写入磁盘

示例：

file, _ := os.Create("output.csv")
defer file.Close()
w := csv.NewWriter(file)
defer w.Flush()
w.WriteAll([][]string{
  {"Name", "Age", "City"},
  {"Bob", "32", "Shanghai"},
  {"Cindy", "25", "Guangzhou"},
})

处理带标题的 CSV（结构体映射）

标准库不直接支持 struct tag 映射，但可手动结合表头做字段对齐，提升可读性与维护性。

先 Read() 获取 headers 切片
构建字段名 → 索引映射（map[string]int）
后续每行用映射查下标，赋值给结构体字段

例如定义 type Person struct { Name, Age, City string }，再根据 headerMap["Name"] 找到对应列位置。

注意编码与分隔符（非 UTF-8 或自定义分隔符）

encoding/csv 默认按 UTF-8 处理，且仅支持逗号分隔。若需其他分隔符（如制表符、分号），可设置 reader.Comma = '\t' 或 w.Comma = ';'。

非 UTF-8 编码（如 GBK）需先用 golang.org/x/text/encoding 转换为 UTF-8 再交给 csv reader
空行、多余空格、BOM 头可能引发解析错误，建议预处理或捕获 error 后跳过

基本上就这些。标准库够用、轻量、稳定，适合大多数 CSV 场景 —— 不复杂但容易忽略 Flush 和错误处理。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。