本文详解如何在 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）。
对应结构体定义需精确匹配嵌套层级与类型：
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⚠️ 常见错误规避：
- 不要省略切片的方括号 [] —— Class: ClassX{...} 是非法的，必须写成 Class: []ClassX{{...}}；
- 若 Class 可能为空，仍需初始化为 []ClassX{}（空切片），而非 nil（虽可序列化为 null，但通常应避免）；
- 使用 json.MarshalIndent 可美化输出，便于调试；
- 建议开启 go vet 和静态检查工具，提前捕获类型不匹配隐患。
掌握结构体字段类型与 JSON 嵌套层级的一一映射，是 Go JSON 序列化的基石。牢记：切片字段 = 切片字面量，结构体字段 = 结构体字面量，即可彻底避免此类编译错误。
