Go 中嵌套 JSON 结构的正确序列化方法-Golang-PHP中文网

Go 中嵌套 JSON 结构的正确序列化方法

本文详解如何在 Go 中正确定义结构体并序列化为多层嵌套 JSON（如含 slice of struct 的深层嵌套），重点解决因类型不匹配（如误将 struct 赋值给 slice 字段）导致的 cannot use struct literal as type []T 编码错误。

本文详解如何在 go 中正确定义结构体并序列化为多层嵌套 json（如含 slice of struct 的深层嵌套），重点解决因类型不匹配（如误将 struct 赋值给 slice 字段）导致的 `cannot use struct literal as type []t` 编码错误。

在 Go 中，将复杂嵌套数据结构编码为 JSON 时，结构体字段类型必须与实际赋值严格一致——尤其是当字段声明为切片（[]T）时，绝不能直接传入单个结构体实例（T），否则会触发编译错误：cannot use T literal as type []T in field value。这正是提问者遇到的核心问题。

我们以目标 JSON 为例：

{"id":[{"name":"Test","Class":[{"Grade":"2","id":"34"}]}],"age":"5"}

其结构层级为：

根对象含 age（string）和 id（数组）；
id 数组每个元素含 name（string）和 Class（数组）；
Class 数组每个元素含 Grade 和 id（均为 string）。

对应结构体定义需精确匹配嵌套层级与类型：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

type ClassX struct {
    Grade string `json:"Grade"` // 注意：JSON key 大小写需与目标一致（原 JSON 中为 "Grade"，非 "grade"）
    ID    string `json:"id"`    // 字段名可自定义，但 tag 必须匹配 JSON 键名
}

type IDX struct {
    Name  string   `json:"name"`
    Class []ClassX `json:"Class"` // ✅ 必须是 slice 类型，且 tag 显式指定为 "Class"
}

type Response struct {
    Age string `json:"age"`
    ID  []IDX  `json:"id"` // 字段名 ID 与 JSON key "id" 通过 tag 关联
}

关键修正点：

Class 字段必须声明为 []ClassX（切片），而非 ClassX（单个结构体）；
初始化时，Class 字段应赋值为 []ClassX{...}，而非 ClassX{...}；
JSON tag 中的键名（如 "Grade"、"Class"、"id"）须与目标 JSON 完全一致（区分大小写）；
推荐使用大驼峰命名（如 ClassX、ID）提升 Go 代码可读性，再通过 json tag 控制序列化输出。

✅ 正确初始化示例：

data := Response{
    Age: "5",
    ID: []IDX{{
        Name: "Test",
        Class: []ClassX{{
            Grade: "2",
            ID:    "34",
        }},
    }},
}

b, err := json.Marshal(data)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(b)) // 输出符合预期的嵌套 JSON

⚠️ 常见错误规避：