GolangCSV文件读写教程详解

本篇文章给大家分享《Golang读写CSV文件教程》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

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的相关知识，也可关注golang学习网公众号。