首页 > Golang > Go教程

GolangCSV处理教程详解

时间：2025-11-23 12:22:27 101浏览收藏

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Golang CSV 文件处理教程》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

Go语言中encoding/csv包用于高效处理CSV文件，支持读取和写入操作。首先使用csv.NewReader读取数据，可调用ReadAll一次性读取或Read逐行读取以节省内存；示例展示了从字符串读取CSV并输出各行内容。接着通过csv.NewWriter写入数据到缓冲区或文件，需调用Flush确保数据写入，并检查Error方法获取错误信息。处理中文时默认支持UTF-8，若源文件为GBK等编码，需借助golang.org/x/text/encoding/simplifiedchinese进行解码转换。对于非逗号分隔的CSV，可通过设置Reader或Writer的Comma字段来自定义分隔符，如分号或制表符。综上，只需注意编码、分隔符及Flush操作，即可稳定处理各类CSV场景。

Golang如何使用 encoding/csv 处理 CSV 文件_Golang CSV 数据解析与写入实践

在 Go 语言中，encoding/csv 包提供了处理 CSV（逗号分隔值）文件的简单而高效的方式。无论是读取用户上传的数据、导出报表，还是与其他系统交换数据，CSV 都是常见格式。本文将通过实际示例展示如何使用该包进行 CSV 数据的解析与写入。

读取 CSV 文件

要从文件或字符串中读取 CSV 数据，可以使用 csv.NewReader 创建一个读取器，然后调用其 ReadAll 或逐行读取 Read 方法。

示例：从字符串读取 CSV 数据

package main

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

func main() {
    csvData := `姓名,年龄,城市
张三,25,北京
李四,30,上海
王五,28,深圳`

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

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

输出结果：

第1行: [姓名年龄城市]
第2行: [张三 25 北京]
第3行: [李四 30 上海]
第4行: [王五 28 深圳]

如果数据量较大，建议逐行读取以节省内存：

for {
    record, err := reader.Read()
    if err == io.EOF {
        break
    }
    if err != nil {
        fmt.Println("读取出错:", err)
        break
    }
    fmt.Println(record)
}

写入 CSV 文件

使用 csv.NewWriter 可将数据写入文件或缓冲区。写入后记得调用 Flush 确保数据落盘。

示例：写入 CSV 到字符串缓冲区

package main

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

func main() {
    var buf strings.Builder
    writer := csv.NewWriter(&buf)

    // 写入表头
    writer.Write([]string{"姓名", "年龄", "城市"})
    // 写入数据行
    writer.Write([]string{"赵六", "32", "广州"})
    writer.Write([]string{"钱七", "29", "杭州"})

    // 必须调用 Flush
    writer.Flush()

    if err := writer.Error(); err != nil {
        fmt.Println("写入失败:", err)
        return
    }

    fmt.Println(buf.String())
}

若要写入文件，只需将 *os.File 传给 NewWriter：

file, _ := os.Create("output.csv")
defer file.Close()
writer := csv.NewWriter(file)
// ... 写入逻辑
writer.Flush()

处理中文与编码问题

CSV 本身不包含编码信息，Go 的 encoding/csv 默认处理 UTF-8。如果源文件是 GBK 或其他编码，需先转换为 UTF-8。

例如使用 golang.org/x/text/encoding/simplifiedchinese 处理 GBK 编码文件：

import (
    "golang.org/x/text/encoding/simplifiedchinese"
    "golang.org/x/text/transform"
)

file, _ := os.Open("data.csv")
defer file.Close()

decoder := simplifiedchinese.GBK.NewDecoder()
reader := csv.NewReader(transform.NewReader(file, decoder.Transform()))

records, _ := reader.ReadAll()

这样可避免中文乱码问题。

自定义分隔符

并非所有“CSV”都用逗号，有些使用制表符或分号。可通过设置 Comma 字段修改分隔符。

示例：读取以分号分隔的 CSV

reader := csv.NewReader(strings.NewReader(data))
reader.Comma = ';'  // 设置分隔符为分号
records, _ := reader.ReadAll()

同样适用于写入：

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

基本上就这些。encoding/csv 虽然简单，但足够应对大多数场景。只要注意编码、分隔符和 Flush，就能稳定处理 CSV 数据。

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