Golang如何使用encoding/csv写入CSV文件_Golang CSV文件写入实践-Golang-PHP中文网

Golang如何使用encoding/csv写入CSV文件_Golang CSV文件写入实践

P粉602998670

发布： 2025-12-05 16:48:52

原创

339人浏览过

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

golang如何使用encoding/csv写入csv文件_golang csv文件写入实践

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

创建并写入CSV文件

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

示例：写入多行数据到 CSV 文件

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 会自动处理这些情况，只需传入原始字符串即可。

立即学习“go语言免费学习笔记（深入）”；

例如：

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

登录后复制

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

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

登录后复制

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

CodeWP

针对 WordPress 训练的AI代码生成器

149

查看详情

自定义分隔符（如制表符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如何使用encoding/csv写入CSV文件_Golang CSV文件写入实践的详细内容，更多请关注php中文网其它相关文章！