Go语言解析与序列化JSON数据实战指南

实现目标与环境准备

我们需要完成两个核心动作：

1. 解析：读取本地的JSON文件内容，将其转换为Go程序中的结构体变量。
2. 序列化：将内存中的结构体变量转换回JSON格式的字节流或字符串。

准备工作：

• 确保已安装Go语言环境。
• 准备一份待处理的JSON数据文件，例如EasyUI风格的表格数据。
  注意：在实际操作中，可以将测试用的JSON数据文件（如datagrid_data1.json）放置在项目源码目录下，或者使用相对/绝对路径指向该文件。
• 引入标准库："encoding/json", "fmt", "io/ioutil"（注：io/ioutil在新版本Go中建议替换为os.ReadFile，但为保持与原例逻辑一致，下文仍沿用经典写法或注明替代方案）。

定义数据结构

JSON通常用于表示对象或数组，而在Go中，最自然的映射方式是使用struct（结构体）。JSON的键名应尽可能匹配结构体的字段名，或通过json tag指定对应关系。

第1步：构建层级结构体

假设原始JSON包含total字段和一个rows数组，每个元素是一个产品对象。我们需要定义对应的两层结构体：

• 内部结构体 (Product)：代表rows数组中的单个项。
• 外部结构体 (Grid)：包含总数统计和列表切片。

重要规则：结构体的字段名称必须以大写字母开头。在Go语言中，只有导出的字段（首字母大写）才能被encoding/json包访问并绑定数据。如果字段是小写开头，反序列化时将静默忽略，导致字段值为零值。

package main

import (
	"encoding/json"
	"fmt"
	"io/ioutil"
)

// Product 对应 JSON rows 数组中的单个对象
type product struct {
	Productid   string  `json:"productid"`
	Productname string  `json:"productname"`
	Unitcost    float32 `json:"unitcost"`
	Status      string  `json:"status"`
	Listprice   float32 `json:"listprice"`
	Attr1       string  `json:"attr1"`
	Itemid      string  `json:"itemid"`
}

// Grid 对应 JSON 根对象
type grid struct {
	Total int        `json:"total"`
	Rows  []product  `json:"rows"`
}

说明：

• `json:"fieldname"`：显式指定JSON键名映射。如果JSON键名与Go字段名完全一致且均符合命名规范，其实也可以省略Tag，但显式写出能避免大小写混淆问题，是推荐做法。
• Rows []product：使用切片类型来接收JSON中的数组。

执行JSON解析与序列化操作

第2步：读取文件并解析JSON

首先读取JSON文件内容到字节切片，然后调用json.Unmarshal进行反序列化。

func main() {
	// 1. 初始化空的结构体变量
	var g grid

	// 2. 读取JSON文件
	data, err := ioutil.ReadFile("datagrid_data1.json")
	if err != nil {
		fmt.Println("ReadFile error:", err.Error())
		return
	}

	// 3. 反序列化：将JSON字节流填充到grid结构体中
	// 必须传入指针 &g，否则 Unmarshal 无法修改原结构体的值
	err = json.Unmarshal(data, &g)
	if err != nil {
		fmt.Println("Unmarshal error:", err.Error())
		return
	}

	// 此时 g 已经被填充了数据
	fmt.Printf("Parsed Total: %d\n", g.Total)
	for _, p := range g.Rows {
		fmt.Printf("Product: %s, Price: %.2f\n", p.Productname, p.Unitcost)
	}
}

关键点：

• err := json.Unmarshal(data, &grid)：务必检查错误返回。未处理的错误可能导致数据静默失败。
• &grid：必须传递结构体的指针。

第3步：将结构体验证并序列化回JSON

为了验证数据是否正确加载，或者需要将内存数据写回给其他组件，我们需要执行正向的序列化操作——json.Marshal。

    // 序列化操作
    b, marshalErr := json.Marshal(g)
    if marshalErr != nil {
        fmt.Println("Marshal error:", marshalErr.Error())
        return
    }
    
    // 输出格式化后的JSON字符串
    fmt.Println(string(b))

json.Marshal返回的是字节切片[]byte，通常使用string()强型转换或直接写入文件。默认情况下，它生成紧凑的JSON；如需美观的输出（带缩进），可使用json.MarshalIndent。

完成判断与注意事项

当控制台打印出正确的总数及产品信息，并且输出的JSON字符串结构清晰、无乱码时，表示转换成功。

• 大小写敏感性：再次强调，若结构体字段小写（如Productid写成productid），Unmarshal将无法赋值，导致结果为空。
• 路径问题）：示例中使用相对路径"datagrid_data1.json"。运行程序时，请确保工作目录（Current Working Directory）包含该文件，或使用绝对路径。
• ioutil vs os：Go 1.16+ 推荐使用os.ReadFile替代ioutil.ReadFile，两者功能相同但后者更语义化。

简要总结

通过定义匹配的Struct并利用json.Unmarshal和json.Marshal，我们完成了从文件到内存、再从内存回到文本的高效转换。掌握结构体字段的导出特性（首字母大写）和错误的正确处理，是Go语言处理JSON的基础技能。

以上就是Go语言中转换JSON数据的详细内容，更多关于Go语言基础知识的资料请关注本站其它相关文章！