如何在 Go 中正确序列化嵌套结构体为 JSON

本文详解 go 语言中将嵌套结构体（含匿名结构体与具名结构体）序列化为符合预期键名格式的 json，解决复合字面量类型缺失错误，并推荐可维护、可扩展的最佳实践。

在 Go 中，将嵌套结构体序列化为结构清晰、键名规范的 JSON 是常见需求。例如，期望输出如下格式：

{"genre": {"country": "taylor swift", "rock": "aimee"}}

但若直接使用匿名嵌套结构体，常会遇到 Missing type in composite literal 编译错误——这是因为 Go 要求匿名结构体的复合字面量必须显式重复其完整类型定义。

✅ 正确写法：显式声明匿名结构体类型

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

resp := Music{
    Genre: struct { // 必须重复定义类型
        Country string
        Rock    string
    }{
        Country: "Taylor Swift",
        Rock:    "Aimee",
    },
}

data, err := json.Marshal(resp)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data)) // 输出: {"genre":{"country":"Taylor Swift","rock":"Aimee"}}

⚠️ 注意：json 标签必须显式添加（如 `json:"country"`），否则默认使用大写首字母字段名（如 "Country"），不符合 JSON 命名惯例。

✅ 推荐方案：定义具名子结构体（更清晰、可复用）

相比匿名结构体，定义独立类型 Genre 更加健壮、易读且支持复用：

Mapify

Mapify是由Xmind推出的AI思维导图生成工具，原名ChatMind

下载

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",
    },
}

data, _ := json.Marshal(resp)
fmt.Println(string(data)) // 同样输出: {"genre":{"country":"Taylor Swift","rock":"Aimee"}}

该方式还带来额外优势：

• 支持在其他结构体中复用 Genre（如 Movie 或 Podcast）；
• 可为 Genre 添加方法（如 Validate() 或 String()）；
• 更利于单元测试与文档生成；
• 避免因嵌套过深导致的可读性下降。

? 补充说明：JSON 字段可见性规则

Go 的 json 包仅序列化导出（首字母大写）字段。若字段为小写（如 country string），即使加了 json:"country" 标签，也会被忽略——因此务必确保字段名首字母大写，仅通过 tag 控制 JSON 键名。

✅ 总结建议

遵循以上实践，即可稳定、清晰地生成符合 API 规范的嵌套 JSON，同时提升代码长期可维护性。