Golang指针JSON序列化反序列化技巧

在Golang中，指针在JSON序列化和反序列化过程中扮演着重要角色，尤其是在处理结构体字段时。本文深入探讨了 `encoding/json` 包如何利用指针来精确表达字段的存在与否以及null值的语义。通过`json.Marshal`，nil指针会被编码为JSON的null，而非nil指针则会解引用输出其值。反序列化时，JSON的null值会使对应指针字段变为nil，而有值时则会分配内存并赋值。结合`omitempty`标签，仅当指针为nil时字段才会被忽略，这在PATCH更新等场景中非常有用。然而，使用指针也需注意解引用可能导致的panic、零值的误判以及潜在的内存开销。掌握这些细节，能有效提升API的表达能力并避免潜在的错误。

指针在Go的JSON序列化中用于精确表达字段是否存在或为null，json.Marshal会将nil指针编码为null，非nil指针解引用后输出值；反序列化时，null值使指针为nil，有值则分配内存；配合omitempty，仅nil指针被忽略，适用于PATCH更新；需注意解引用panic、零值误判和内存开销。

在Go语言中，指针与JSON的序列化和反序列化密切相关，尤其是在处理结构体字段时。使用指针可以更灵活地表达“字段是否存在”或“是否为null”的语义，这在API交互中非常常见。理解指针在 encoding/json 包中的行为，有助于避免空指针、意外的默认值或丢失字段等问题。

指针字段的序列化（struct → JSON）

当结构体字段是指针类型时，json.Marshal 会自动解引用指针，将其值写入JSON。如果指针为 nil，对应字段在JSON中会输出为 null。

type User struct {
    Name *string `json:"name"`
    Age  *int    `json:"age"`
}

name := "Alice"
age := 25

user := User{
    Name: &name,
    Age:  nil, // 指针为空
}

data, _ := json.Marshal(user)
fmt.Println(string(data)) // 输出: {"name":"Alice","age":null}

可以看到，Age 字段为 nil 指针，序列化后变成 JSON 的 null。这在表示“可选字段”时非常有用。

指针字段的反序列化（JSON → struct）

在反序列化时，如果JSON字段值为 null 或存在，json.Unmarshal 会根据结构体字段是否为指针来决定如何处理。

若字段是指针类型：

• JSON值为 null → 指针设为 nil
• JSON值为实际数据 → 分配内存并赋值，指针非nil

jsonStr := `{"name":null,"age":30}`
var user User
json.Unmarshal([]byte(jsonStr), &user)

// user.Name == nil
// user.Age != nil, *user.Age == 30

这种机制允许你判断某个字段是否显式设置为 null（指针为 nil），还是未提供（但结构体标签未使用 omitempty 时仍会解析为 null）。

与 omitempty 的配合使用

在结构体标签中使用 omitempty 时，指针的行为会影响字段是否被忽略。

• 基本类型字段：零值（如 0, "", false）会被忽略
• 指针字段：只有指针为 nil 时才忽略

type Profile struct {
    Nickname *string `json:"nickname,omitempty"`
    Active   *bool   `json:"active,omitempty"`
}

如果 Nickname 是 nil 指针，该字段不会出现在输出JSON中。但如果它指向一个空字符串（""），字段仍会输出："nickname":""。

这种特性适合用于部分更新（PATCH）场景，nil 表示“不更新”，非nil表示“更新为此值，哪怕是零值”。

常见问题与注意事项

使用指针处理JSON时，容易出现以下问题：

• 解引用nil指针：反序列化后未判断是否为nil就使用 *ptr，会panic
• 误判零值：指针非nil但指向零值，可能不符合业务逻辑预期
• 内存开销：每个非nil字段都会分配内存，大量小对象可能影响性能

建议在访问指针字段前做nil判断，或封装安全的 Getter 方法。

今天关于《Golang指针JSON序列化反序列化技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！