Golang读写CSV文件教程详解

本篇文章给大家分享《Golang如何处理CSV文件？详细读写教程》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

用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文件其实挺方便的，标准库里的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
}

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

常见问题和注意事项

• 编码问题：确保你的CSV文件是UTF-8编码，如果不是，可能需要先转码。
• 字段数量不一致：有些CSV可能存在某行字段数不对的情况，可以设置 reader.FieldsPerRecord = -1 来允许不同长度。
• 性能考虑：对于特别大的CSV文件，不要一次性读入内存，而是按行处理。
• 错误处理：读写时务必检查错误，尤其是在生产环境中。

基本上就这些内容。用Golang处理CSV不算复杂，但也有一些细节容易忽略，比如格式兼容性、大文件处理等。只要掌握上面这些方法，日常开发中基本够用了。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~