如何将嵌套结构体正确序列化为 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 精确控制输出字段名与大小写。

? 验证输出

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 响应。