Golang读写CSV文件教程

本文深入探讨了 Golang 中如何利用 `encoding/csv` 包进行高效的 CSV 文件读写操作，并结合百度 SEO 优化，旨在帮助开发者快速掌握相关技能。文章详细讲解了 `csv.NewReader` 和 `csv.NewWriter` 的典型用法，包括如何创建读取器和写入器，以及如何通过 `ReadAll` 和 `Read` 方法读取数据，并通过 `Write` 和 `WriteAll` 方法写入数据。同时，重点强调了 `Flush` 方法的重要性，确保数据完整写入磁盘。此外，文章还介绍了如何自定义配置分隔符、注释字符等选项，并针对实际开发中常见的首行处理、错误处理、大文件内存控制以及编码问题提供了实用建议，助力开发者在 Go 语言项目中轻松应对 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的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~