如何使用 easyjson 将 JSON 数组反序列化为 Go 结构体切片-Golang-PHP中文网

如何使用 easyjson 将 JSON 数组反序列化为 Go 结构体切片

本文详解如何借助 easyjson 高效解析 JSON 数组（如 [{"Item1":true,"Item2":"hello",...}]）并映射到 Go 结构体切片，解决 UnmarshalEasyJSON 不支持直接作用于 []T 的核心问题。

本文详解如何借助 easyjson 高效解析 json 数组（如 `[{"item1":true,"item2":"hello",...}]`）并映射到 go 结构体切片，解决 `unmarshaleasyjson` 不支持直接作用于 `[]t` 的核心问题。

easyjson 要求所有需序列化/反序列化的类型必须显式声明 //easyjson:json 标签，并生成对应的 UnmarshalEasyJSON 方法。但该方法仅对具名类型（named type）可用，而 Go 内置的切片类型 []Item 是未命名类型（unnamed type），因此无法直接调用 UnmarshalEasyJSON —— 这正是你遇到编译错误或 panic 的根本原因。

正确的做法是：定义一个具名的切片类型，并为其添加 //easyjson:json 注释。例如：

//easyjson:json
type ItemSlice []Item

该类型本质上等价于 []Item，但因具备名称和 easyjson 标签，easyjson 工具会在生成的 _easyjson.go 文件中为其自动生成 UnmarshalEasyJSON 和 MarshalEasyJSON 方法。

完整实现如下：

抖音下载器(Node.js)

抖音无水印视频下载和文案提取工具

下载

package something

import "github.com/mailru/easyjson/jlexer"

//easyjson:json
type Item struct {
    Item1 bool     `json:"Item1"`
    Item2 string   `json:"Item2"`
    Item3 SubItem  `json:"Item3"`
}

//easyjson:json
type SubItem struct {
    A int `json:"A"`
}

//easyjson:json
type ItemSlice []Item // ✅ 关键：具名切片类型

// ConvertJSONToItems 将 JSON 数组字符串反序列化为 Item 切片
func ConvertJSONToItems(jsondata string) []Item {
    var items ItemSlice // 使用具名类型接收
    lexer := jlexer.Lexer{Data: []byte(jsondata)}

    items.UnmarshalEasyJSON(&lexer)
    if lexer.Error() != nil {
        panic(lexer.Error())
    }

    return []Item(items) // 类型转换：ItemSlice → []Item（零拷贝，安全）
}

✅ 注意事项：

必须运行 easyjson -all your_file.go 重新生成 _easyjson.go，确保 ItemSlice 的序列化/反序列化方法被生成；
字段建议显式添加 json:"..." 标签，提升可读性与兼容性（尤其当 JSON 键名含大小写混合或特殊字符时）；
ItemSlice 到 []Item 的转换是底层共享底层数组的类型转换，无内存复制开销，性能无损；
若后续还需将切片再序列化为 JSON，同样可直接对 ItemSlice 调用 MarshalEasyJSON，无需额外适配。