Golang写入CSV文件详细教程

本文详细介绍了如何在 Golang 中使用 `encoding/csv` 包进行 CSV 文件的写入操作。通过本文，你将学会如何创建 CSV 文件、写入表头和多行数据，以及如何处理包含逗号、引号等特殊字符的字段。此外，文章还讲解了如何自定义分隔符（例如制表符 TSV），以及如何将结构体切片数据转换为 CSV 格式。最后，强调了 `Flush` 方法的重要性，确保数据能够成功写入磁盘。掌握这些技巧，能够帮助你轻松地在 Go 项目中生成和处理 CSV 文件，满足导出日志、生成报表等多种需求。

Go语言中encoding/csv包用于读写CSV文件，支持写入多行数据、处理特殊字符、自定义分隔符及从结构体切片生成CSV。1. 创建文件并使用csv.NewWriter写入表头和记录；2. Write和WriteAll方法自动处理含逗号、引号的字段；3. 设置Comma字段可改为制表符分隔（TSV）；4. 结构体需手动转为字符串切片写入；5. 必须调用Flush确保数据落盘。标准库适用于大多数场景，复杂需求可用第三方库增强。

在Go语言中，encoding/csv 包提供了对CSV（逗号分隔值）文件的读写支持。使用它写入CSV文件非常直观，适合处理表格数据，比如导出日志、生成报表或保存结构化信息。下面通过实际示例演示如何正确使用该包将数据写入CSV文件。

创建并写入CSV文件

要写入CSV文件，需要先创建一个文件句柄，然后使用 csv.NewWriter 创建一个写入器，接着调用 Write 或 WriteAll 方法写入记录。

package main

import (
    "encoding/csv"
    "os"
)

func main() {
    // 创建文件
    file, err := os.Create("users.csv")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    // 创建 CSV 写入器
    writer := csv.NewWriter(file)
    defer writer.Flush()

    // 写入表头
    header := []string{"Name", "Age", "Email"}
    if err := writer.Write(header); err != nil {
        panic(err)
    }

    // 写入多行数据
    records := [][]string{
        {"Alice", "25", "alice@example.com"},
        {"Bob", "30", "bob@example.com"},
        {"Charlie", "35", "charlie@example.com"},
    }

    if err := writer.WriteAll(records); err != nil {
        panic(err)
    }
}

运行后会生成 users.csv，内容如下：

Name,Age,Email
Alice,25,alice@example.com
Bob,30,bob@example.com
Charlie,35,charlie@example.com

处理包含特殊字符的数据

CSV 标准支持字段中包含逗号、换行符或引号，encoding/csv 会自动处理这些情况，只需传入原始字符串即可。

例如：

record := []string{"Smith, John", "28", `"Engineer" at XYZ`}
writer.Write(record)

生成的CSV会自动用双引号包裹包含特殊字符的字段：

"Smith, John",28,"""Engineer"" at XYZ"

无需手动添加引号，Write 方法会按规范转义。

自定义分隔符（如制表符TSV）

如果需要写入以制表符分隔的文件（TSV），可以修改 Writer 的 Comma 字段。

示例：写入 TSV 文件

file, _ := os.Create("data.tsv")
writer := csv.NewWriter(file)
writer.Comma = '\t' // 设置分隔符为制表符

writer.Write([]string{"Name", "City"})
writer.Write([]string{"Alice", "Beijing"})
writer.Flush()
file.Close()

这样生成的就是标准的 TSV 文件，适用于某些系统或工具的导入需求。

从结构体切片写入CSV

实际开发中，数据通常来自结构体。虽然 encoding/csv 不直接支持结构体标签，但可以手动转换。

示例：

type User struct {
    Name  string
    Age   int
    Email string
}

users := []User{
    {"Alice", 25, "alice@example.com"},
    {"Bob", 30, "bob@example.com"},
}

writer := csv.NewWriter(file)
writer.Write([]string{"Name", "Age", "Email"}) // 表头

for _, u := range users {
    record := []string{u.Name, fmt.Sprintf("%d", u.Age), u.Email}
    writer.Write(record)
}
writer.Flush()

注意：需手动将非字符串字段（如 int）转为字符串。

基本上就这些。encoding/csv 使用简单，关键是记得调用 Flush 确保数据写入磁盘，并合理处理错误。对于更复杂的场景（如自动结构体映射），可考虑第三方库如 github.com/gocarina/gocsv，但标准库已足够应对大多数基础写入任务。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~