Go语言中JSON数据到CSV格式的转换教程-Golang-PHP中文网

Go语言中JSON数据到CSV格式的转换教程

聖光之護

发布： 2025-10-10 11:28:15

原创

730人浏览过

Go语言中JSON数据到CSV格式的转换教程

本教程详细介绍了如何在Go语言中将JSON数据转换为CSV格式。文章重点阐述了使用encoding/json和encoding/csv包进行数据处理的步骤，特别是解决了在写入CSV时常见的类型不匹配错误，即csv.Writer.Write方法要求[]string类型参数的问题，并提供了将非字符串类型转换为字符串的实用方法，确保数据正确写入CSV文件。

1. 引言

在数据处理和交换中，json（javascript object notation）和csv（comma separated values）是两种非常常见的数据格式。json以其灵活的结构常用于web api和配置文件，而csv则因其简洁和易于被电子表格软件处理的特性，广泛应用于数据导出和报告。在go语言中，我们经常需要将从api或其他源获取的json数据转换为csv格式，以便进行进一步的分析或共享。本教程将指导您如何在go中高效地完成这一转换，并解决过程中可能遇到的常见问题。

2. Go语言中JSON到CSV转换的基础

Go语言标准库提供了强大的工具来处理JSON和CSV数据：

encoding/json 包用于JSON的编码和解码。
encoding/csv 包用于CSV的读写。

转换过程通常包括以下几个步骤：

读取JSON数据：从文件或网络请求中获取JSON字节流。
解析JSON数据：使用json.Unmarshal将JSON字节流解析为Go结构体或接口类型。
创建CSV文件：打开或创建一个新的CSV文件用于写入。
写入CSV数据：遍历解析后的Go数据结构，将每条记录转换为CSV行并写入文件。

3. 定义数据结构

首先，我们需要定义一个Go结构体来匹配我们的JSON数据结构。例如，如果我们的JSON数据如下：

[
  {
    "recordId": 101,
    "Date of joining": "2023-01-15",
    "Employee ID": "EMP001"
  },
  {
    "recordId": 102,
    "Date of joining": "2023-02-20",
    "Employee ID": "EMP002"
  }
]

登录后复制

我们可以定义以下Go结构体：

立即学习“go语言免费学习笔记（深入）”；

type JsonRecord struct {
    RecordID int64  `json:"recordId"`
    DOJ      string `json:"Date of joining"`
    EmpID    string `json:"Employee ID"`
}

登录后复制

注意结构体字段上的 json:"..." 标签，它告诉 encoding/json 包如何将JSON字段映射到Go结构体字段。

4. 核心转换逻辑与常见问题解决

在将JSON数据转换为CSV时，一个常见的错误是csv.Writer.Write方法要求[]string类型的参数，而我们的Go结构体可能包含int64或其他非字符串类型。

错误示例分析：

考虑以下尝试写入CSV的代码片段，它会导致类型错误：

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

// 假设 d 是 []JsonRecord 类型
/*
for _, obj := range d {
  var record []interface{} // 错误：csv.Writer.Write 不接受 []interface{}
  record = append(record, obj.RecordID)
  record = append(record, obj.DOJ)
  record = append(record, obj.EmpID)
  w.Write(record) // 这里会报错：cannot use record (type []interface {}) as type []string in function argument
}
*/

登录后复制

csv.Writer.Write方法的签名是func (w *Writer) Write(record []string) error，它明确要求一个字符串切片。因此，任何非字符串类型在写入CSV之前都必须转换为字符串。

正确的解决方案：

我们需要确保在构建要写入CSV的行时，所有字段都是string类型。对于int64等数字类型，可以使用strconv包进行转换。

以下是完整的Go语言代码示例，演示了如何正确地将JSON数据转换为CSV，并处理了类型转换：

package main

import (
    "encoding/csv"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "os"
    "strconv" // 引入 strconv 包用于类型转换
)

// JsonRecord 定义了JSON数据的结构
type JsonRecord struct {
    RecordID int64  `json:"recordId"`
    DOJ      string `json:"Date of joining"`
    EmpID    string `json:"Employee ID"`
}

func main() {
    // 1. 读取JSON文件
    // 假设存在一个名为 people.json 的文件，内容如前所述
    data, err := ioutil.ReadFile("./people.json")
    if err != nil {
        fmt.Printf("读取JSON文件失败: %v\n", err)
        return
    }

    // 2. 解析JSON数据
    var records []JsonRecord
    err = json.Unmarshal(data, &records)
    if err != nil {
        fmt.Printf("解析JSON数据失败: %v\n", err)
        return
    }

    // 3. 创建CSV文件
    f, err := os.Create("./people.csv")
    if err != nil {
        fmt.Printf("创建CSV文件失败: %v\n", err)
        return
    }
    defer f.Close() // 确保文件在函数结束时关闭

    // 4. 初始化CSV写入器
    w := csv.NewWriter(f)

    // 可选：写入CSV头部
    headers := []string{"RecordID", "Date of Joining", "Employee ID"}
    if err := w.Write(headers); err != nil {
        fmt.Printf("写入CSV头部失败: %v\n", err)
        return
    }

    // 5. 遍历JSON记录并写入CSV
    for _, obj := range records {
        var recordRow []string // 定义一个 []string 类型切片用于存储当前行数据

        // 将 int64 类型的 RecordID 转换为字符串
        recordRow = append(recordRow, strconv.FormatInt(obj.RecordID, 10))
        recordRow = append(recordRow, obj.DOJ)
        recordRow = append(recordRow, obj.EmpID)

        // 写入CSV行
        if err := w.Write(recordRow); err != nil {
            fmt.Printf("写入CSV行失败: %v\n", err)
            return
        }
    }

    // 6. 刷新写入器缓冲区，确保所有数据都写入文件
    w.Flush()
    if err := w.Error(); err != nil {
        fmt.Printf("刷新CSV写入器失败: %v\n", err)
        return
    }

    fmt.Println("JSON数据已成功转换为CSV文件: people.csv")
}

登录后复制

为了运行上述代码，您需要创建一个 people.json 文件，例如：

[
  {
    "recordId": 101,
    "Date of joining": "2023-01-15",
    "Employee ID": "EMP001"
  },
  {
    "recordId": 102,
    "Date of joining": "2023-02-20",
    "Employee ID": "EMP002"
  },
  {
    "recordId": 103,
    "Date of joining": "2023-03-10",
    "Employee ID": "EMP003"
  }
]

登录后复制

运行程序后，将生成一个 people.csv 文件，内容如下：

RecordID,Date of Joining,Employee ID
101,2023-01-15,EMP001
102,2023-02-20,EMP002
103,2023-03-10,EMP003

登录后复制

5. 注意事项与最佳实践

错误处理：在文件操作、JSON解析和CSV写入过程中，务必进行全面的错误检查。这有助于识别问题并使程序更加健壮。
资源管理：使用defer f.Close()确保文件句柄在操作完成后被正确关闭，防止资源泄漏。
类型转换：对于int、float、bool等非字符串类型，在写入CSV之前必须使用strconv包中的相应函数（如strconv.FormatInt、strconv.FormatFloat、strconv.FormatBool）将其转换为字符串。
CSV头部：通常建议在CSV文件的第一行写入列标题，这有助于接收方理解数据内容。
w.Flush()：在完成所有写入操作后，调用w.Flush()至关重要，它会将缓冲区中的所有待写入数据强制写入到底层文件，否则文件可能为空或数据不完整。
动态字段处理：如果JSON结构不固定，或者您希望动态地选择要导出的字段，可以考虑使用map[string]interface{}来解析JSON，然后遍历map的键值对，但这会增加类型断言和转换的复杂性。

6. 总结

通过本教程，您应该已经掌握了在Go语言中将JSON数据转换为CSV格式的核心方法。关键在于正确地解析JSON数据到Go结构体，并在写入CSV时，确保所有数据字段都已转换为字符串类型，以满足csv.Writer.Write方法的严格要求。遵循错误处理和资源管理的最佳实践，将使您的数据转换程序更加可靠和高效。

以上就是Go语言中JSON数据到CSV格式的转换教程的详细内容，更多请关注php中文网其它相关文章！