Go语言json.Marshal未提升字段被忽略是否为预期行为？

没错，这绝对是encoding/json包的刻意设计，背后是Go语言结构体字段提升规则和JSON序列化逻辑共同作用的结果，咱们一步步拆解来看：

首先搞懂Go的结构体字段提升规则 #

当你把Transaction作为匿名字段嵌入Message时，Go会自动把嵌套结构体的可导出字段"提升"到外层结构体——但这里有个关键前提：如果外层结构体已经存在同名的可导出字段，嵌套结构体的同名字段就不会被提升。

就像你的示例里，Message自己已经有Type字段，所以Transaction里的Type只能通过m.Transaction.Type访问，没法直接用m.Type调用，它不属于外层结构体的"直接字段"。

再看json.Marshal的序列化逻辑 #

encoding/json包在序列化结构体时，只会处理外层结构体可直接访问的可导出字段：

• 对于被提升的字段，它等同于外层结构体自己的字段，会被正常序列化；
• 对于未被提升的嵌套结构体字段，因为它必须通过嵌套结构体的名称（比如Transaction）才能访问，默认情况下不会被自动序列化到JSON中——这是为了避免出现JSON键冲突（如果两个Type都序列化，JSON里会出现重复的"Type"键，这是不符合JSON规范的）。

验证一下：让嵌套结构体字段被序列化 #

如果我们想让嵌套的Transaction字段及其内部的Type被序列化，只需要给匿名字段加上json标签，显式指定它的JSON键名：

type Message struct { 
    Type string 
    Transaction `json:"transaction"` // 加上json标签
} 
type Transaction struct { 
    Type string 
} 
m := &Message{ 
    Type: "mType", 
    Transaction: Transaction{ 
        Type: "txType", 
    }, 
} 
j, _ := json.Marshal(m) 
fmt.Println(string(j))

这时候输出就会变成：{"Type":"mType","transaction":{"Type":"txType"}}，说明只要我们显式声明，嵌套结构体的字段就能被正常序列化。

总结 #

这种行为是刻意设计的：

• 既遵循了Go语言结构体字段提升的规则，保证了语言特性的一致性；
• 又避免了JSON序列化时出现重复键的问题，符合JSON的规范；
• 同时还给开发者留足了灵活处理的空间，可以通过标签控制是否序列化嵌套结构体。

内容的提问来源于stack exchange，提问作者webbyweb