Golang指针在JSON处理中 序列化与反序列化问题

指针在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 会根据结构体字段是否为指针来决定如何处理。

立即学习“go语言免费学习笔记（深入）”；

若字段是指针类型：

• 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）。

Designs.ai

AI设计工具

下载

与 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 方法。