Golang怎么处理嵌套struct JSON扁平化_Golang如何将嵌入结构体的字段提升到外层JSON输出【技巧】-Golang-PHP中文网

go struct嵌入字段json不自动扁平化是设计使然；需指针类型+json:",inline"才生效，否则须手动实现marshaljson完全控制输出。

golang怎么处理嵌套struct json扁平化_golang如何将嵌入结构体的字段提升到外层json输出【技巧】

Go struct 嵌入字段不自动扁平化 JSON 是设计使然

Go 的 json 包默认不会把嵌入结构体（anonymous struct field）的字段“提一层”到外层 JSON 对象里——哪怕你用了 json:",inline"，它也只对 map、slice 或指针类型生效，对普通嵌入 struct 无效。这是很多人踩坑的起点：以为加个 json:",inline" 就能扁平，结果字段还在二级 key 下。

用 `json:",inline"` + 指针嵌入才能真正扁平

要让嵌入 struct 的字段出现在外层 JSON 中，必须满足两个条件：嵌入字段是**指针类型**，且显式标注 json:",inline"。值类型嵌入即使加了 inline 也无效。

常见错误写法：

type User struct {
    Name string `json:"name"`
    Info Info   `json:",inline"` // ❌ Info 是值类型，inline 被忽略
}
type Info struct {
    Age  int `json:"age"`
    City string `json:"city"`
}

正确做法：

把嵌入字段改为指针：Info *Info `json:",inline"`
序列化前确保指针非 nil（否则字段全丢）
如果 Info 可能为空，需额外处理零值逻辑，比如自定义 MarshalJSON

手动实现扁平化：重写 `MarshalJSON` 最可控

当嵌入结构体可能为 nil、或需要动态控制字段是否出现时，json:",inline" 就不够用了。这时候直接实现 MarshalJSON 方法最稳妥，完全掌控输出结构。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

关键点：

不能直接调用 json.Marshal 原 struct（会递归触发自己，死循环）
要用 struct{...} 字面量或 map[string]interface{} 构造中间数据
注意字段名大小写和 tag 一致性，比如 Name 字段带 json:"name"，就得手动映射过去

示例片段：

func (u User) MarshalJSON() ([]byte, error) {
    type Alias User // 防止无限递归
    return json.Marshal(struct {
        *Alias
        Age  int    `json:"age"`
        City string `json:"city"`
    }{
        Alias: (*Alias)(&u),
        Age:   u.Info.Age,
        City:  u.Info.City,
    })
}