2024年Go最新Golang CSV Reader(4)，2024年最新1个月学会Golang开发

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

什么是 CSV 文件？

CSV 文件是一种以纯文本形式存储表格数据的文件格式。它以逗号作为字段分隔符，以换行符作为记录分隔符。每一行都表示一个记录（行），并且在该行中，字段（列）由逗号分隔。

以下是一个简单的 CSV 文件示例：

name,age,city
John,25,New York
Lisa,30,San Francisco

在上面的示例中，第一行是标题行，指定了每个字段的名称。从第二行开始，每一行是一个记录，其中每个字段之间用逗号分隔。

CSV 文件可以存储各种类型的数据，包括字符串、数值、日期等。它的简单格式使得它在数据交换和存储中非常受欢迎。

Golang 的 CSV Reader

Golang 提供了一个内置的 CSV Reader 包，位于 encoding/csv 包中。该包提供了一个 Reader 结构体，用于读取、解析和处理 CSV 文件。

基本用法

首先，我们需要导入 encoding/csv 包：

import "encoding/csv"

然后，我们可以使用 csv.NewReader() 函数创建一个新的 CSV Reader：

reader := csv.NewReader(file)

在上面的代码中，我们传入一个 io.Reader 接口类型的参数 file，它代表一个已经打开的 CSV 文件。这将创建一个新的 CSV Reader 对象，用于读取和解析该文件。

读取记录

我们可以使用 Read() 方法从 CSV 文件中读取一行记录（行），并将其作为字符串切片返回。例如：

record, err := reader.Read()
if err == io.EOF {
    // 表示已到达文件末尾
} else if err != nil {
    // 处理其他错误
} else {
    // 处理读取到的记录
}

在上面的代码中，Read() 方法返回两个值：一个是包含读取记录的字符串切片，另一个是一个错误。当读取到文件末尾时，Read() 方法会返回 io.EOF 错误。

解析字段

默认情况下，CSV Reader 将记录解析为字符串切片，其中每个字段都是一个字符串。但是，通过调用 Read() 方法之前，我们可以设置 CSV Reader 的选项来自定义字段解析的行为。

例如，我们可以使用 Comma 选项设置字段的分隔符字符。默认值为逗号（','），但我们也可以将其更改为其他字符，如分号（';'）：

reader.Comma = ';'

其他常用的选项包括：

• FieldsPerRecord：用于指定每个记录的字段数目。默认值为 -1，表示每一行可以有任意数量的字段。如果设置了其他值，则在字段数目不匹配时，Read() 方法将返回 csv.ErrFieldCount 错误。
• TrimLeadingSpace：用于指定是否删除字段周围的空格。默认值为 false，即保留字段周围的空格。

处理错误

在使用 CSV Reader 读取和解析 CSV 文件时，需要处理一些错误情况。例如，Read() 方法可能返回 csv.ErrFieldCount 错误，表示记录中的字段数目不匹配。

同时，还需要处理其他可能的错误情况，如打开文件失败、读取文件失败等。这些错误处理将帮助我们识别和调试潜在的问题，并保证程序的稳定性。

完整示例

让我们通过一个完整的示例来演示如何使用 Golang 的 CSV Reader。

假设我们有一个名为 data.csv 的 CSV 文件，包含一些学生的姓名和年龄信息，以逗号分隔。以下是一个示例文件：

name,age
Alice,21
Bob,22
Charlie,23

现在，我们可以使用以下代码将其读取和解析为 Golang 中的数据结构：

package main

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

type Student struct {
	Name string
	Age  int
}

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

	reader := csv.NewReader(file)

	// 解析字段为字符串切片
	reader.FieldsPerRecord = -1

	// 读取每一行记录
	records, err := reader.ReadAll()
	if err != nil {
		fmt.Println("读取文件失败:", err)
		return
	}

	// 处理每一行记录
	students := []Student{}
	for \_, record := range records {
		student := Student{
			Name: record[0],
			Age:  record[1],
		}
		students = append(students, student)
	}

	// 打印学生信息
	for \_, student := range students {
		fmt.Println("姓名:", student.Name)
		fmt.Println("年龄:", student.Age)
		fmt.Println()
	}
}

在上面的代码中，我们定义了一个 Student 结构体，用于存储学生的姓名和年龄信息。

在 main() 函数中，我们首先打开 CSV 文件，然后创建一个 CSV Reader 对象。然后，我们设置 FieldsPerRecord 选项为 -1，以允许每个记录具有不同的字段数目。

接下来，我们使用 ReadAll() 方法从文件中读取所有的记录，并将其存储在 records 变量中。然后，我们使用 for 循环遍历每个记录，并将其解析为 Student 结构体。最后，我们将解析后的学生信息打印出来。

最佳实践

在使用 Golang 的 CSV Reader 进行 CSV 文件处理时，以下是一些最佳实践建议：

• 始终检查并处理错误。无论是打开文件、读取文件还是解析记录，在每个可能出错的步骤之后都应该检查并处理错误。
• 使用适当的选项。根据实际情况，根据 CSV 文件的格式和要求，设置适当的选项，如分隔符、字段数目等。
• 适当处理大型文件。对于大型的 CSV 文件，为了减少内存占用，我们可以使用 Read() 方法逐行读取和处理记录，而不是一次读取整个文件。

案例

以下是三个使用Golang的CSV Reader的案例：

案例一：计算平均值

假设我们有一个存储学生成绩的CSV文件，它的格式如下：

name,math,english,science
Alice,95,90,85
Bob,88,92,90
Charlie,92,88,95

我们想要计算每个学生的平均成绩，并打印出来。下面是使用CSV Reader实现的示例代码：

package main

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

type Student struct {
	Name   string
	Math   float64
	English float64
	Science float64
}

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

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

	students := []Student{}
	for \_, record := range records[1:] {


![img](https://img-blog.csdnimg.cn/img_convert/3ae69c7e05ea34fa179f9388a3c32424.png)
![img](https://img-blog.csdnimg.cn/img_convert/f18c1b51268d7e0b8e90e80a8ab9f081.png)

**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化的资料的朋友，可以添加戳这里获取](https://bbs.csdn.net/topics/618658159)**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**

[外链图片转存中...(img-GUWxYsUR-1715632239864)]

**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化的资料的朋友，可以添加戳这里获取](https://bbs.csdn.net/topics/618658159)**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**