当前位置：首页 > 文章列表 > Golang > Go教程 > GolangCSV读写技巧全解析

GolangCSV读写技巧全解析

2025-12-20 14:18:34 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

亲爱的编程学习爱好者，如果你点开了这篇文章，说明你对《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 数据。

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

第五人格匹配队友技巧大全

上一篇: 第五人格匹配队友技巧大全

下一篇: CSS清除浮动：after伪元素实现clearfix方法

查看更多