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

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()。
立即学习“go语言免费学习笔记(深入)”;
- 每一行是
[]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 和错误处理。










