首页 > Golang > Go教程

GolangCSV操作教程：encoding/csv使用指南

时间：2025-09-01 13:02:41 178浏览收藏

本篇文章向大家介绍《Golang CSV读写教程：encoding/csv使用详解》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

Go语言的encoding/csv包提供内置CSV读写功能，无需外部依赖。使用csv.NewReader可从文件、字符串等io.Reader读取数据，ReadAll()一次性读取所有行，或用Read()逐行处理以节省内存。写入时通过csv.NewWriter将数据写入io.Writer，需调用Flush()确保数据落盘，或使用WriteAll()批量写入。该包自动处理含逗号、换行、引号的字段，支持自定义分隔符如分号或制表符，适用于大多数结构化数据处理场景。

如何使用Golang的encoding/csv包来读取和写入CSV文件

Go语言的encoding/csv包提供了读取和写入CSV文件的简单而高效的方式。它内置于标准库中，无需额外安装依赖，适合处理结构化数据，比如从Excel导出的表格或数据库导出的文本数据。

读取CSV文件

使用csv.NewReader可以从任意io.Reader（如文件、字符串、网络流）读取CSV数据。通常配合os.Open打开本地文件。

以下是一个读取CSV文件的完整示例：

package main

import (
    "encoding/csv"
    "fmt"
    "os"
)

func main() {
    file, err := os.Open("data.csv")
    if err != nil {
        fmt.Println("打开文件失败:", err)
        return
    }
    defer file.Close()

    reader := csv.NewReader(file)
    records, err := reader.ReadAll()
    if err != nil {
        fmt.Println("读取CSV失败:", err)
        return
    }

    for i, record := range records {
        fmt.Printf("第%d行: %v\n", i+1, record)
    }
}

说明：

csv.NewReader(file)创建一个CSV读取器。
ReadAll()一次性读取所有行，返回[][]string，每一行是一个字符串切片。
若需逐行读取以节省内存，可使用reader.Read()循环处理。

写入CSV文件

使用csv.NewWriter可以将数据写入任何io.Writer，比如文件或网络响应。

示例如下：

package main

import (
    "encoding/csv"
    "os"
)

func main() {
    file, err := os.Create("output.csv")
    if err != nil {
        fmt.Println("创建文件失败:", err)
        return
    }
    defer file.Close()

    writer := csv.NewWriter(file)
    defer writer.Flush() // 必须调用Flush，否则数据可能未写入

    records := [][]string{
        {"姓名", "年龄", "城市"},
        {"张三", "25", "北京"},
        {"李四", "30", "上海"},
    }

    for _, record := range records {
        if err := writer.Write(record); err != nil {
            fmt.Println("写入行失败:", err)
            return
        }
    }
}

说明：

csv.NewWriter(file)创建写入器。
必须调用writer.Flush()，确保缓冲区数据写入底层IO。
也可以使用writer.WriteAll(records)一次性写入多行。

处理带引号或特殊字符的数据

CSV包会自动处理包含逗号、换行或引号的字段。你只需正常传入字符串，写入器会自动加引号并转义。

例如：

writer.Write([]string{"Alice", "Engineer", "喜欢\"编程\"和,写代码"})

生成的CSV会正确转义为：

Alice,Engineer,"喜欢""编程""和,写代码"

读取时也会自动还原这些转义内容，无需手动处理。

自定义分隔符

默认使用逗号分隔，但可通过设置Comma字段改为其他字符，比如制表符或分号。

例如读取以分号分隔的文件：

reader := csv.NewReader(file)
reader.Comma = ';'

写入时也可同样设置：

writer := csv.NewWriter(file)
writer.Comma = '\t' // 使用制表符

基本上就这些。encoding/csv包简单直接，适合大多数CSV处理场景，只要注意Flush和错误处理即可。

本篇关于《GolangCSV操作教程：encoding/csv使用指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！

golang csv encoding/csv csv.NewReader csv.NewWriter