当前位置：首页 > 文章列表 > Golang > Go教程 > Golang如何读写CSV文件？详细教程分享

Golang如何读写CSV文件？详细教程分享

2025-07-02 09:30:00 0浏览收藏

还在为Golang处理CSV文件而烦恼吗？本文将带你深入了解如何使用Golang标准库`encoding/csv`轻松实现CSV文件的读写操作。从`csv.NewReader()`创建读取器，到`ReadAll()`高效读取，再到`csv.NewWriter()`灵活写入，我们详细讲解了Golang处理CSV文件的各种场景，包括大文件逐行读取、字段解析设置以及带标题行的结构体映射等实用技巧。此外，本文还总结了常见的编码问题、字段数量不一致等注意事项，助你避免踩坑，掌握Golang处理CSV文件的精髓，提升开发效率。

用Golang处理CSV文件方便，因标准库encoding/csv提供全面功能。读取CSV可用csv.NewReader()创建读取器，通过os.Open打开文件后用ReadAll()一次性读取全部内容为二维字符串切片，大文件建议逐行读取；可设置reader.Comma和reader.TrimLeadingSpace以正确解析字段。写入CSV使用csv.NewWriter()创建写入器，并调用Write方法写入数据，最后务必调用Flush()确保数据写入磁盘。处理带标题行的CSV时可通过结构体映射字段，需手动实现转换逻辑。注意事项包括：确保UTF-8编码、允许字段数量不一致时设置FieldsPerRecord=-1、避免大文件内存占用过高、以及错误检查必须到位。掌握这些要点即可满足日常开发需求。

怎样用Golang处理CSV文件 Golang读写CSV文件的详细教程

用Golang处理CSV文件其实挺方便的，标准库里的encoding/csv包已经提供了很全面的功能。不管是读取还是写入CSV，都可以不用依赖第三方库搞定。

下面我分几个常见操作场景来说明怎么用Golang读写CSV文件。

读取CSV文件

读取CSV文件是最常见的需求之一。比如你有一个用户信息表，想导入到程序里处理。

Go 提供了 csv.NewReader() 方法来创建一个 CSV 读取器：

file, err := os.Open("users.csv")
if err != nil {
    log.Fatal(err)
}
defer file.Close()

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

这样就能把整个 CSV 文件一次性读进来，records 是一个二维字符串切片，每行是一个子切片。

注意：如果你处理的是大文件，建议用 Read() 方法逐行读取，避免内存占用过高。

如果字段中有逗号或者换行符，记得设置一下解析方式：

reader.Comma = ',' // 默认是逗号，也可以改成其他符号
reader.TrimLeadingSpace = true // 忽略空格

写入CSV文件

写入就更简单了。比如你想生成一份报表导出为 CSV。

使用 csv.NewWriter() 创建一个写入器：

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

writer := csv.NewWriter(file)
defer writer.Flush()

headers := []string{"Name", "Age", "City"}
data := [][]string{
    {"Alice", "30", "New York"},
    {"Bob", "25", "Los Angeles"},
}

writer.Write(headers)
for _, record := range data {
    writer.Write(record)
}

这段代码会创建一个包含表头和两行数据的 CSV 文件。

小技巧：writer.Flush() 一定要记得调用，否则可能会有数据没写进去。

处理带标题行的CSV

很多CSV文件第一行是列名，比如“姓名、年龄、城市”。这时候可以用结构体配合标签来映射字段。

虽然标准库不直接支持结构体绑定，但你可以自己写个辅助函数，比如：

type User struct {
    Name string
    Age  int
    City string
}

func readUsers(reader *csv.Reader) ([]User, error) {
    records, err := reader.ReadAll()
    if err != nil {
        return nil, err
    }

    var users []User
    for i, record := range records {
        if i == 0 {
            continue // 跳过表头
        }
        user := User{
            Name: record[0],
            Age:  strconv.Atoi(record[1]),
            City: record[2],
        }
        users = append(users, user)
    }
    return users, nil
}

这样就可以把每一行数据转换成结构体，方便后续逻辑处理。