首页 > Golang > Go教程

GolangCSV读写教程及代码示例

时间：2025-12-29 13:39:48 234浏览收藏

从现在开始，努力学习吧！本文《Golang CSV读写教程及示例代码》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

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 和错误处理。

本篇关于《GolangCSV读写教程及代码示例》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！