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

Go语言中JSON数据到CSV文件的转换教程

霞舞

发布： 2025-10-09 10:51:04

原创

853人浏览过

Go语言中JSON数据到CSV文件的转换教程

本教程旨在指导开发者如何在Go语言中高效地将JSON数据转换为CSV格式。文章将重点解决在数据转换过程中常见的类型不匹配错误，特别是csv.Writer.Write方法对[]string类型参数的要求，并提供详细的Go语言代码示例，涵盖JSON读取、解析、数据类型转换以及CSV写入的全过程，确保输出数据的正确性和程序的健壮性。

1. 理解JSON到CSV转换的挑战

在数据处理领域，将结构化的json数据转换为表格化的csv格式是一项常见任务，尤其是在数据分析、导入导出或报告生成场景中。go语言提供了强大的标准库来处理这两种数据格式，但开发者在实践中常会遇到一些细节问题。其中一个典型问题是，encoding/csv包中的csv.writer.write方法要求其参数为[]string类型，这意味着所有待写入的字段都必须是字符串。如果json数据中包含整数、浮点数或布尔值等非字符串类型，直接将其放入[]interface{}然后尝试写入csv文件，将会导致运行时类型错误。

例如，如果尝试使用[]interface{}来构建行记录：

// 错误的示例片段
// var record []interface{}
// record = append(record, obj.RecordID) // RecordID 是 int64 类型
// 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函数签名明确要求[]string。解决此问题的核心在于，在将数据传递给csv.Writer.Write之前，确保所有非字符串类型的数据都被正确地转换为字符串。

2. Go语言中JSON到CSV的完整实现

下面将通过一个完整的Go语言程序来演示如何安全、高效地将JSON数据转换为CSV文件。

2.1 定义JSON数据结构

首先，我们需要定义一个Go语言结构体来匹配我们的JSON数据格式。结构体字段上的json:"..."标签用于指定JSON字段名与Go结构体字段的映射关系。

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

假设我们的people.json文件内容如下：

Find JSON Path Online

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

查看详情

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

登录后复制

对应的Go结构体定义：

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

登录后复制

2.2 读取和解析JSON数据

程序首先需要从文件中读取JSON数据，并将其反序列化（Unmarshal）到Go结构体切片中。

package main

import (
    "encoding/csv"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "os"
    "strconv" // 用于整数到字符串的转换
)

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

func main() {
    // 1. 读取JSON文件
    data, err := ioutil.ReadFile("./people.json")
    if err != nil {
        fmt.Printf("Error reading JSON file: %v\n", err)
        return
    }

    // 2. 反序列化JSON数据到Go结构体切片
    var d []Json
    err = json.Unmarshal(data, &d)
    if err != nil {
        fmt.Printf("Error unmarshaling JSON data: %v\n", err)
        return
    }

    // ... 后续CSV写入代码
}

登录后复制

2.3 创建CSV文件并写入数据

接下来，我们将创建或打开一个CSV文件，并使用encoding/csv包提供的csv.NewWriter来写入数据。关键在于，在将每个字段添加到record切片之前，确保它已经被转换为字符串类型。对于int64类型的RecordID字段，我们使用strconv.FormatInt函数将其转换为字符串。

    // ... 前面的JSON读取和解析代码

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

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

    // 可选：写入CSV文件头
    header := []string{"RecordID", "Date of joining", "Employee ID"}
    if err := w.Write(header); err != nil {
        fmt.Printf("Error writing CSV header: %v\n", err)
        return
    }

    // 5. 遍历JSON数据并写入CSV
    for _, obj := range d {
        var record []string // 关键：声明为 []string 类型

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

        if err := w.Write(record); err != nil {
            fmt.Printf("Error writing record to CSV: %v\n", err)
            return
        }
    }

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

    fmt.Println("JSON data successfully converted to people.csv")
}

登录后复制

2.4 完整示例代码

结合上述所有步骤，以下是完整的Go语言程序代码：

package main

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

// Json 结构体定义，用于匹配 JSON 数据结构
type Json struct {
    RecordID int64  `json:"recordId"`
    DOJ      string `json:"Date of joining"`
    EmpID    string `json:"Employee ID"`
}

func main() {
    // 1. 读取 JSON 文件
    // 假设 people.json 文件与 Go 程序在同一目录下
    data, err := ioutil.ReadFile("./people.json")
    if err != nil {
        fmt.Printf("Error reading JSON file: %v\n", err)
        return
    }

    // 2. 反序列化 JSON 数据到 Go 结构体切片
    var d []Json
    err = json.Unmarshal(data, &d)
    if err != nil {
        fmt.Printf("Error unmarshaling JSON data: %v\n", err)
        return
    }

    // 3. 创建 CSV 文件
    f, err := os.Create("./people.csv")
    if err != nil {
        fmt.Printf("Error creating CSV file: %v\n", err)
        return
    }
    defer f.Close() // 确保文件句柄在函数退出前关闭

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

    // 5. 写入 CSV 文件头（可选，但推荐）
    header := []string{"RecordID", "Date of joining", "Employee ID"}
    if err := w.Write(header); err != nil {
        fmt.Printf("Error writing CSV header: %v\n", err)
        return
    }

    // 6. 遍历解析后的 JSON 数据，并将其转换为 CSV 行
    for _, obj := range d {
        // 创建一个 []string 切片来存储当前行的所有字段
        var record []string

        // 将 int64 类型的 RecordID 转换为字符串，基数为10
        record = append(record, strconv.FormatInt(obj.RecordID, 10))
        // 直接添加字符串类型的字段
        record = append(record, obj.DOJ)
        record = append(record, obj.EmpID)

        // 将构建好的 []string 记录写入 CSV 文件
        if err := w.Write(record); err != nil {
            fmt.Printf("Error writing record to CSV: %v\n", err)
            return
        }
    }

    // 7. 刷新写入器缓冲区，确保所有数据都已写入磁盘
    w.Flush()
    // 检查 Flush 过程中是否发生错误
    if err := w.Error(); err != nil {
        fmt.Printf("Error flushing CSV writer: %v\n", err)
        return
    }

    fmt.Println("JSON data successfully converted to people.csv")
}

登录后复制

3. 注意事项与最佳实践

错误处理： 在实际应用中，对文件操作、JSON解析和CSV写入的每一步都进行严格的错误检查至关重要。本教程中的示例代码已经包含了基本的错误处理。
类型转换： encoding/csv包的Write方法只接受[]string类型的参数。对于JSON中非字符串类型（如int, float, bool），必须使用strconv包中的相应函数（如FormatInt, FormatFloat, FormatBool）将其转换为字符串。
资源管理： 使用defer f.Close()可以确保文件句柄在函数执行完毕后被正确关闭，防止资源泄露。
csv.Writer.Flush()： csv.Writer内部通常会有一个缓冲区。调用Flush()方法可以确保所有缓冲的数据都被写入底层的io.Writer（在本例中是文件），这对于确保数据完整性非常重要。在程序结束前，务必调用Flush()。
CSV文件头： 在写入数据之前，通常会写入一行作为CSV文件的列头，这有助于提高CSV文件的可读性和易用性。
复杂JSON结构： 对于嵌套的JSON对象或数组，可能需要更复杂的逻辑来扁平化数据或创建多个相关的CSV文件。这通常涉及到递归处理或定义更复杂的Go结构体。

4. 总结

本教程详细阐述了如何在Go语言中将JSON数据转换为CSV格式，并重点解决了csv.Writer.Write方法要求[]string类型参数的问题。通过明确定义Go结构体、正确读取和解析JSON、以及在写入CSV前进行必要的类型转换，我们可以高效且健壮地完成这一常见的数据处理任务。掌握这些技术将有助于开发者在Go项目中更灵活地处理不同格式的数据。

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