首页 > Golang > Go教程

GolangCSV读写教程与代码示例

时间：2025-12-25 09:43:34 400浏览收藏

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《Golang CSV读写教程及示例代码》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

Go语言中encoding/csv包用于读写CSV文件，支持标准及自定义分隔符的解析与生成，能自动处理带引号字段。1. 使用csv.NewReader读取文件或字符串数据，可调用ReadAll()一次性读取或循环Read()逐行读取；2. 使用csv.NewWriter写入数据到文件或缓冲区，需调用Flush()确保数据写入；3. 支持自定义分隔符，如制表符或分号，通过设置Comma字段实现；4. 自动处理含逗号、换行等特殊字符的字段，无需手动解析引号内容。示例涵盖打开文件、创建读写器、遍历记录、错误处理及资源释放全过程，适用于报表导出、配置导入等场景。

如何使用Golang encoding/csv处理CSV文件_Golang CSV文件读写示例

在Go语言中，encoding/csv 包提供了对CSV（逗号分隔值）文件的读写支持。它属于标准库，无需额外安装，适合处理结构化数据，比如导出报表、导入配置或解析日志。下面通过具体示例说明如何使用它进行CSV文件的读取与写入。

读取CSV文件

使用 csv.NewReader 可以从任何实现了 io.Reader 接口的对象中读取数据，常见的是从文件或字符串中读取。

以下是从本地CSV文件读取所有记录的示例：

package main

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

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

    // 创建CSV读取器
    reader := csv.NewReader(file)

    // 读取所有行
    records, err := reader.ReadAll()
    if err != nil {
        fmt.Println("读取CSV失败:", err)
        return
    }

    // 遍历输出每一行
    for _, record := range records {
        fmt.Println(record)
    }
}

假设 data.csv 内容如下：

姓名,年龄,城市
张三,25,北京
李四,30,上海

运行程序将输出：

[姓名 年龄 城市]
[张三 25 北京]
[李四 30 上海]

如果想逐行读取以节省内存（适合大文件），可以使用 reader.Read()：

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

写入CSV文件

使用 csv.NewWriter 可以将数据写入任何实现了 io.Writer 接口的对象，如文件或缓冲区。

以下示例将数据写入新的CSV文件：

package main

import (
    "encoding/csv"
    "os"
)

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

    // 创建CSV写入器
    writer := csv.NewWriter(file)
    defer writer.Flush() // 确保所有数据写入磁盘

    // 准备要写入的数据
    data := [][]string{
        {"姓名", "年龄", "城市"},
        {"张三", "25", "北京"},
        {"李四", "30", "上海"},
    }

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

执行后会生成 output.csv 文件，内容为：

姓名,年龄,城市
张三,25,北京
李四,30,上海

注意： 必须调用 writer.Flush()，否则数据可能不会真正写入文件。

处理带引号或特殊字符的字段

CSV规范允许字段包含逗号、换行符或引号，这时需要使用双引号包裹字段。encoding/csv 会自动处理这些情况。

例如，某个字段包含逗号：

data := [][]string{
    {"用户", "地址"},
    {"王五", "广东省,深圳市"},
}

写入后CSV内容为：

用户,地址
王五,"广东省,深圳市"

读取时也会正确解析带引号的字段，无需手动处理。

自定义分隔符

有些CSV文件使用制表符（TSV）或其他字符作为分隔符。可以通过设置 Comma 字段来自定义：

reader := csv.NewReader(file)
reader.Comma = '\t' // 使用制表符分隔

writer := csv.NewWriter(file)
writer.Comma = ';'  // 使用分号分隔

这在处理非标准格式时非常有用。

基本上就这些。encoding/csv 简单高效，配合 os 和 bufio 可轻松完成大多数CSV操作。不复杂但容易忽略细节，比如 Flush 和错误处理，写生产代码时要格外注意。

理论要掌握，实操不能落！以上关于《GolangCSV读写教程与代码示例》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！