Go struct嵌入字段JSON不自动扁平化是设计使然；需指针类型+json:",inline"才生效，否则须手动实现MarshalJSON完全控制输出。
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"`
}
正确做法：
立即学习“go语言免费学习笔记（深入）”；
- 把嵌入字段改为指针：
Info *Info `json:",inline"` - 序列化前确保指针非 nil（否则字段全丢）
- 如果 Info 可能为空，需额外处理零值逻辑，比如自定义
MarshalJSON
手动实现扁平化：重写 MarshalJSON 最可控
当嵌入结构体可能为 nil、或需要动态控制字段是否出现时，json:",inline" 就不够用了。这时候直接实现 MarshalJSON 方法最稳妥，完全掌控输出结构。
关键点：
- 不能直接调用
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,
})
}
第三方库如 mapstructure 或 go-json 不解决根本问题
有人试过用 mapstructure.Decode 先转 map 再 flatten，或换更快的 go-json 库——但这些都不改变 Go 原生 JSON 规则。嵌入 struct 的扁平化本质是**序列化策略问题**，不是性能或兼容性问题。
真正要注意的其实是边界场景：
- 嵌入字段含同名字段（比如两个 struct 都有
ID），手动MarshalJSON时得明确取舍 - 嵌入 struct 本身还有嵌入字段，
inline不会递归展开，必须逐层处理 - 测试时别只看非 nil case，nil 指针、空 struct、零值字段的 JSON 输出容易漏验
嵌套越深，手动控制越必要；依赖 tag 的写法看着省事，出问题时反而更难定位。
