如何将嵌套结构体正确序列化为 JSON

在 go 中，将嵌套结构体正确序列化为符合预期键名和层级的 json，需注意复合字面量语法、字段标签（`json:` tag）以及类型定义的可维护性。

Go 的 json.Marshal 默认会将导出字段（首字母大写）转为 JSON 键，但键名默认为驼峰式（如 Country → "Country"），且嵌套结构体若使用匿名类型，初始化时必须显式重复类型定义，否则会报错 missing type in composite literal。

✅ 正确方式一：显式匿名结构体字面量（不推荐用于生产）

type Music struct {
    Genre struct {
        Country string `json:"country"`
        Rock    string `json:"rock"`
    } `json:"genre"`
}

resp := Music{
    Genre: struct {
        Country string `json:"country"`
        Rock    string `json:"rock"`
    }{
        Country: "Taylor Swift",
        Rock:    "Aimee",
    },
}

⚠️ 注意：此处必须完整重复匿名结构体定义（含 json tag），否则编译失败；且无法复用，可读性和可维护性差。

✅ 推荐方式二：定义具名嵌套结构体（最佳实践）

type Genre struct {
    Country string `json:"country"`
    Rock    string `json:"rock"`
}

type Music struct {
    Genre Genre `json:"genre"`
}

resp := Music{
    Genre: Genre{
        Country: "Taylor Swift",
        Rock:    "Aimee",
    },
}

这样不仅语法简洁（无需重复类型），还能复用 Genre 类型、支持方法绑定、便于单元测试，并通过 json tag 精确控制输出字段名与大小写。

PPT.AI

AI PPT制作工具

下载

? 验证输出

js, err := json.Marshal(resp)
if err != nil {
    http.Error(w, err.Error(), http.StatusInternalServerError)
    return
}
w.Header().Set("Content-Type", "application/json")
w.Write(js)
// 输出：{"genre":{"country":"Taylor Swift","rock":"Aimee"}}

? 关键要点总结

• 所有需 JSON 序列化的字段必须是导出字段（首字母大写）；
• 使用 json:"key" 标签指定输出键名，支持小写、下划线等格式；
• 匿名结构体在复合字面量中需完整写出类型定义，易出错且不可复用；
• 优先定义具名子结构体，提升代码清晰度、可维护性与类型安全；
• 实际项目中，还可结合 omitempty（如 json:"country,omitempty"）避免空值输出。

遵循以上方式，即可稳定、清晰地生成如 {"genre": {"country": "taylor swift", "rock": "aimee"}} 这类嵌套 JSON 响应。