Golang读写CSV文件方法详解

想要高效处理CSV文件？本文为你提供一份详尽的Golang读写CSV文件教程。利用Go语言的`encoding/csv`包，你可以轻松实现CSV文件的读取和写入操作。读取时，通过`csv.NewReader`创建读取器，选择`ReadAll`一次性读取或`Read`逐行处理。写入时，使用`csv.NewWriter`创建写入器，通过`Write`或`WriteAll`添加数据，并务必调用`Flush`提交。本文还将深入探讨如何自定义分隔符、注释字符等高级配置，以及在实际开发中需要注意的首行处理、错误处理及大文件内存控制等关键问题。无论你是数据导入导出还是日志分析，掌握这些技巧都能让你在Golang中游刃有余地处理CSV文件。

Go语言中使用encoding/csv包可高效处理CSV文件读写。读取时用csv.NewReader创建读取器，通过ReadAll一次性读取或Read逐行处理；写入时用csv.NewWriter创建写入器，调用Write或WriteAll添加数据并需调用Flush提交；支持设置分隔符、注释字符等配置项，并需注意首行处理、错误处理及大文件内存控制。

读取和写入 CSV 文件在 Go 语言中非常常见，尤其是处理数据导入导出、日志分析等场景。Go 标准库中的 encoding/csv 包已经提供了简洁又实用的 API 来完成这些操作，不需要引入额外依赖。

使用 csv.NewReader 读取 CSV 文件

读取 CSV 文件的核心是使用 csv.NewReader 创建一个读取器，然后通过 ReadAll 或逐行读取的方式获取数据。

import (
    "encoding/csv"
    "os"
)

file, err := os.Open("data.csv")
if err != nil {
    // 处理错误
}
defer file.Close()

reader := csv.NewReader(file)
records, err := reader.ReadAll()

上面这段代码会一次性把整个 CSV 文件的内容读进来，结果是一个二维字符串切片（[][]string），每一项代表一行记录，每行又是多个字段组成的字符串数组。

如果你希望按行处理，比如文件很大或者需要边读边处理，可以这样：

for {
    record, err := reader.Read()
    if err == io.EOF {
        break
    }
    // 处理每一行数据
}

小提示：如果 CSV 文件包含表头，可以在读完后跳过第一行，或者用结构体映射字段名来提升可读性。

使用 csv.NewWriter 写入 CSV 文件

写入 CSV 的流程也很简单：创建一个写入器，然后调用 Write 方法添加每一行数据，最后记得调用 Flush 提交写入。

file, _ := os.Create("output.csv")
defer file.Close()

writer := csv.NewWriter(file)
writer.Write([]string{"name", "age", "city"})
writer.Write([]string{"Alice", "30", "Beijing"})
writer.Flush()

如果你想批量写入多条数据，可以用 WriteAll：

rows := [][]string{
    {"name", "age", "city"},
    {"Bob", "25", "Shanghai"},
    {"Charlie", "28", "Guangzhou"},
}
writer.WriteAll(rows)

注意：每次写入之后都要调用 Flush()，否则可能有部分内容还在缓冲区没有落盘。如果你忘了，那写出来的文件内容可能是不完整的。

设置分隔符和其他选项

默认情况下，encoding/csv 假设你用的是逗号作为字段分隔符。但有些时候 CSV 文件可能用了别的符号，比如制表符 \t，这时候就需要自定义配置了。

reader := csv.NewReader(file)
reader.Comma = '\t' // 改成制表符分隔

类似的，写入时也可以设置：

writer := csv.NewWriter(file)
writer.Comma = '\t'

除了分隔符，还有几个常用配置项：

• reader.Comment：指定注释字符，默认禁用
• reader.FieldsPerRecord：校验每行字段数量是否一致（设为 -1 表示不限）
• writer.UseCRLF：控制是否用 \r\n 换行（Windows 风格）

实际开发中的一些注意事项

• 首行处理：很多 CSV 文件第一行是列名。你可以手动跳过，或者结合结构体标签来做更清晰的映射。
• 错误处理不能省：读写过程中可能出现各种错误，比如格式不对、字段缺失等，建议对 err 做合理判断。
• 大文件处理：读取特别大的 CSV 文件时，尽量用逐行读取方式，避免内存占用过高。
• 编码问题：标准库默认处理 UTF-8 编码，如果不是这个编码，需要先做转换。

基本上就这些。只要掌握了 NewReader 和 NewWriter 的基本用法，配合一些配置参数，就可以应对大部分 CSV 文件的读写需求了。

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