首页 > Golang > Go教程

Golang写入CSV文件方法详解

时间：2026-01-26 13:40:34 450浏览收藏

从现在开始，努力学习吧！本文《Golang写入CSV文件教程详解》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

Go语言通过encoding/csv包写入CSV文件，需用csv.NewWriter创建写入器并调用Write或WriteAll写入数据，每行以[]string格式传入，示例中先写入表头再批量写入记录，关键步骤包括创建文件、写入数据、延迟调用writer.Flush()确保缓冲区数据落盘。逐行写入适用于大数据量场景，需对每行调用Write并手动Flush，最后检查writer.Error()获取写入错误。CSV仅支持字符串，非字符串类型需转换，如使用strconv.Itoa将整数转为字符串。结构体数据可遍历后逐字段转为字符串切片写入。完整流程包含文件创建、数据转换、写入、刷新与错误处理，确保高效稳定生成CSV文件。

Golang如何写入CSV文件_Golang CSV文件写入实践详解

在Go语言中处理CSV文件非常方便，标准库encoding/csv提供了完整的读写支持。写入CSV文件的核心是使用csv.NewWriter创建一个写入器，然后通过Write或WriteAll方法将数据写入目标文件或流。

创建并写入CSV文件

要将数据写入CSV文件，先创建一个文件句柄，再用csv.NewWriter包装它。每行数据以字符串切片[]string的形式传入。

示例代码：

package main

import (
    "encoding/csv"
    "os"
)

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

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

    // 写入表头
    header := []string{"姓名", "年龄", "城市"}
    if err := writer.Write(header); err != nil {
        panic(err)
    }

    // 写入多行数据
    records := [][]string{
        {"张三", "25", "北京"},
        {"李四", "30", "上海"},
        {"王五", "28", "深圳"},
    }
    if err := writer.WriteAll(records); err != nil {
        panic(err)
    }
}

注意：调用writer.Flush()非常重要，它会把缓冲区的数据真正写入文件。延迟调用defer writer.Flush()可以确保写入完成。

逐行写入与错误处理

如果数据量较大或需要流式处理，建议逐行写入，避免内存占用过高。同时应加入适当的错误检查。

例如：

for _, record := range records {
    if err := writer.Write(record); err != nil {
        // 处理每一行写入的错误
        panic(err)
    }
}
// 手动刷新
writer.Flush()
if err := writer.Error(); err != nil {
    panic(err)
}

说明：Write()不会立即写入磁盘，必须调用Flush()。之后可通过writer.Error()检查是否有写入错误。

写入非字符串类型的数据

CSV只支持字符串格式，因此需要将整数、浮点数等转换为字符串。

常用方式是使用strconv包：

import "strconv"

age := 30
city := "广州"
row := []string{"赵六", strconv.Itoa(age), city}
writer.Write(row)

结构体数据可先转换为字符串切片再写入：

type Person struct {
    Name string
    Age  int
    City string
}

people := []Person{
    {"Alice", 26, "杭州"},
    {"Bob", 33, "成都"},
}

for _, p := range people {
    record := []string{p.Name, strconv.Itoa(p.Age), p.City}
    writer.Write(record)
}
writer.Flush()

基本上就这些。Go的CSV写入操作简洁高效，只要注意及时刷新缓冲区、正确处理类型转换和错误，就能稳定生成所需文件。

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

前往漫画官网入口并下载 ➜