当前位置：首页 > 文章列表 > Golang > Go教程 > GolangCSV文件处理教程详解

GolangCSV文件处理教程详解

2025-07-20 11:29:19 0浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang处理CSV文件教程详解》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

用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
}

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