登录
首页 >  Golang >  Go教程

Golang读取CSV文件教程详解

时间：2026-02-17 15:26:34 224浏览 收藏

本文深入讲解了Go语言标准库encoding/csv包读取CSV文件的完整实践方案，涵盖一次性加载、流式逐行解析、标题行智能映射为键值对，以及自定义分隔符、注释忽略、字段校验等灵活配置，既满足小文件快速处理需求，又保障大文件内存安全，辅以清晰示例和关键注意事项，是Go开发者高效、健壮处理各类CSV数据不可或缺的实用指南。

Golang如何使用encoding/csv读取CSV文件_Golang CSV文件读取与解析方法

在Go语言中，encoding/csv 包提供了读取和写入CSV（逗号分隔值）文件的功能。它属于标准库，无需额外安装，使用简单且高效。下面介绍如何使用该包读取并解析CSV文件。

1. 基本的CSV文件读取

要读取一个CSV文件，可以使用 csv.NewReader() 创建一个读取器，然后调用其 ReadAll() 或逐行读取 Read() 方法。

示例：读取整个CSV文件内容

package main

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

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

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

    // 读取所有记录
    records, err := reader.ReadAll()
    if err != nil {
        log.Fatal(err)
    }

    // 遍历每一行
    for _, record := range records {
        // record 是一个字符串切片，表示一行数据
        for i, field := range record {
            print(field)
            if i < len(record)-1 {
                print(",")
            }
        }
        println()
    }
}

2. 按行读取处理大文件

当CSV文件较大时，一次性读取全部内容可能占用过多内存。此时应使用 Read() 方法逐行读取。

reader := csv.NewReader(file)
for {
    record, err := reader.Read()
    if err == io.EOF {
        break
    }
    if err != nil {
        log.Fatal(err)
    }
    // 处理单行数据
    println(strings.Join(record, "|"))
}

这种方式适合处理大型CSV文件，避免内存溢出。

3. 解析带标题行的CSV文件

很多CSV文件第一行为字段名（标题行），我们可以先读取标题，再将后续每行映射为键值对。

header, err := reader.Read()
if err != nil {
    log.Fatal(err)
}

for {
    record, err := reader.Read()
    if err == io.EOF {
        break
    }
    if err != nil {
        log.Fatal(err)
    }

    // 将每行转为 map[字段名]值
    row := make(map[string]string)
    for i, value := range record {
        if i < len(header) {
            row[header[i]] = value
        }
    }

    // 使用 row 进行后续操作
    println("Name:", row["name"], ", Age:", row["age"])
}

4. 自定义分隔符与配置选项

并非所有CSV都使用逗号作为分隔符，有些使用制表符或分号。可以通过设置 Comma 字段来自定义。

reader := csv.NewReader(file)
reader.Comma = ';' // 设置分隔符为分号
reader.TrimLeadingSpace = true // 忽略字段前的空格

其他常用配置：

  • Comma：指定分隔符，默认为 ','
  • Comment：指定注释字符，如 '#' 开头的行将被忽略
  • FieldsPerRecord：要求每行字段数量一致，-1 表示不限制
  • TrimLeadingSpace：是否忽略字段前的空格

基本上就这些。通过 encoding/csv 可以灵活高效地处理各种CSV格式文件，结合文件操作即可完成导入、解析等常见任务。注意错误处理和资源释放，确保程序健壮性。

本篇关于《Golang读取CSV文件教程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！

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