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

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

P粉602998670

发布： 2025-07-30 10:27:02

原创

194人浏览过

用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语言免费学习笔记（深入）”；

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。

小绿鲸英文文献阅读器

英文文献阅读器，专注提高SCI阅读效率

199

查看详情

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

登录后复制

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