深入理解 Go 语言 encoding/json 包（结构体匿名字段的 JSON 序列化与反序列化技巧）

什么是匿名字段？

在 Go 中，结构体可以“嵌入”其他类型，这种语法称为匿名字段。它不是通过命名字段的方式引入，而是直接写类型名。例如：

type Person struct {    Name string}type Employee struct {    Person // 这就是匿名字段（嵌入）    ID   int}

此时，Employee 自动拥有 Person 的所有字段（如 Name），可以直接通过 e.Name 访问。

匿名字段在 JSON 序列化中的表现

当我们使用 json.Marshal 将包含匿名字段的结构体转换为 JSON 时，encoding/json 默认会将匿名字段的字段“展开”到外层对象中。来看一个例子：

package mainimport (    "encoding/json"    "fmt")type Address struct {    City  string `json:"city"`    State string `json:"state"`}type User struct {    Name    string  `json:"name"`    Age     int     `json:"age"`    Address         // 匿名字段}func main() {    u := User{        Name: "Alice",        Age:  30,        Address: Address{            City:  "Beijing",            State: "BJ",        },    }    data, _ := json.Marshal(u)    fmt.Println(string(data))}

输出结果为：

{"name":"Alice","age":30,"city":"Beijing","state":"BJ"}

可以看到，Address 的字段 city 和 state 被“提升”到了顶层，而不是嵌套在一个 address 对象里。这就是 encoding/json 对匿名字段的默认处理方式。

如何让匿名字段保持嵌套？

有时我们希望保留嵌套结构，比如生成如下 JSON：

{"name":"Alice","age":30,"address":{"city":"Beijing","state":"BJ"}}

这时，只需给匿名字段加上 JSON 标签即可：

type User struct {    Name    string  `json:"name"`    Age     int     `json:"age"`    Address `json:"address"` // 添加 json 标签}

这样，encoding/json 就会把 Address 当作一个普通字段处理，并使用 address 作为键名。

反序列化（JSON → 结构体）时的注意事项

在使用 json.Unmarshal 时，规则同样适用：

• 如果匿名字段没有 JSON 标签，JSON 中的顶层字段会尝试匹配匿名结构体内的字段。
• 如果匿名字段有 JSON 标签，则 JSON 中必须存在对应名称的嵌套对象。

例如，使用上面带标签的 User 结构体，反序列化以下 JSON 才能成功：

{  "name": "Bob",  "age": 25,  "address": {    "city": "Shanghai",    "state": "SH"  }}

总结

通过本文，我们深入学习了 Go语言 中 encoding/json 包如何处理结构体的匿名字段。关键点如下：

• 默认情况下，匿名字段的子字段会被“提升”到 JSON 顶层。
• 若需保持嵌套结构，需为匿名字段添加 json:"xxx" 标签。
• 序列化与反序列化的行为一致，需确保 JSON 结构与结构体定义匹配。

掌握这些技巧，你就能更灵活地控制 JSON序列化 的输出格式，写出更清晰、可维护的 Go 代码！

关键词回顾：Go语言、encoding/json、匿名字段、JSON序列化