登录
首页 >  Golang >  Go教程

GolangCSV包使用教程

时间：2026-02-24 22:41:54 199浏览 收藏

Go语言的`encoding/csv`包提供了简洁高效的CSV文件读写能力，不仅支持标准逗号分隔，还能灵活自定义分隔符（如分号、制表符），自动处理含逗号、引号或换行符的复杂字段，避免手动转义；小文件可用`ReadAll()`一键加载，大文件则推荐逐行`Read()`以节省内存，写入时务必调用`Flush()`确保数据落盘——掌握这些关键点，你就能安全、可靠地在Go项目中驾驭各类CSV数据场景。

如何在Golang中使用encoding/csv处理CSV文件

在Go语言中，encoding/csv 包提供了读取和写入CSV（逗号分隔值）文件的简单方式。它能处理标准格式的CSV数据，也支持自定义分隔符。下面介绍如何使用这个包进行常见操作。

读取CSV文件

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

示例：从文件读取CSV内容

package main

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

func main() {
    file, err := os.Open("data.csv")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    reader := csv.NewReader(file)
    records, err := reader.ReadAll()
    if err != nil {
        panic(err)
    }

    for _, record := range records {
        fmt.Println(record) // 每一行是一个[]string
    }
}

说明：

  • csv.NewReader(file) 创建一个默认以逗号分隔的读取器。
  • ReadAll() 一次性读取所有行，适合小文件。
  • 每一行是 []string 类型，字段已自动解析。

如果想逐行读取大文件，避免内存占用过高：

for {
    record, err := reader.Read()
    if err == io.EOF {
        break
    }
    if err != nil {
        panic(err)
    }
    fmt.Println(record)
}

写入CSV文件

使用 csv.NewWriter 将数据写入文件或其他输出流。

package main

import (
    "encoding/csv"
    "os"
)

func main() {
    file, err := os.Create("output.csv")
    if err != nil {
        panic(err)
    }
    defer file.Close()

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

    records := [][]string{
        {"Name", "Age", "City"},
        {"Alice", "30", "Beijing"},
        {"Bob", "25", "Shanghai"},
    }

    for _, record := range records {
        err := writer.Write(record)
        if err != nil {
            panic(err)
        }
    }
}

注意：writer.Flush() 非常关键，它会把缓冲区的数据写入底层IO。不调用可能导致数据未保存。

自定义分隔符

有些CSV文件使用制表符或分号作为分隔符。可以通过设置 Comma 字段来更改。

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

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

确保读写时使用的分隔符一致，否则数据会解析错误。

处理包含特殊字符的字段

CSV规范允许字段中包含逗号、换行符或引号，这些字段会被引号包围。encoding/csv 能自动处理这类情况。

例如这一行：

"John Doe","Engineer, Developer","San Francisco"

会被正确解析为三个字段，中间字段包含逗号但不会被错误分割。

写入时，如果字段包含分隔符或引号，encoding/csv 会自动加上引号包裹，无需手动处理。

基本上就这些。encoding/csv 使用起来简洁高效，适合大多数场景。只要注意 Flush 和分隔符设置，就能安全地处理结构化文本数据。

好了，本文到此结束，带大家了解了《GolangCSV包使用教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>