Golang指针字段在JSON序列化中的行为如何_Golang json pointer编码解码规则

Go中结构体指针字段JSON序列化时，非nil指针输出值，nil指针输出null，配合omitempty可省略；反序列化时自动分配内存，null值使指针为nil，常用于区分零值与未设置，需注意判空防panic。

在Go语言中，结构体的指针字段在JSON序列化和反序列化时的行为与普通字段有所不同。理解这些规则对于正确处理API数据、配置解析以及跨服务通信非常重要。

指针字段的JSON序列化规则

当使用 encoding/json 包对包含指针字段的结构体进行编码（marshal）时：

• 如果指针非nil，会将指针指向的值写入JSON
• 如果指针为nil，对应字段在JSON中输出为 null
• 可以通过 omitempty 标签控制nil指针是否出现在输出中

示例：

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

name := "Alice"
age := 25

u := User{
    Name: &name,
    Age:  nil,
}

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

注意：Age字段因是nil且带有 omitempty，未出现在结果中。

指针字段的JSON反序列化行为

在解码（unmarshal）JSON到结构体时，指针字段的处理逻辑如下：

• JSON中的每个字段都会尝试赋值给结构体对应字段
• 如果结构体字段是指针类型，json包会自动分配内存并把值存入指针指向的位置
• JSON中字段为 null 时，对应指针字段会被设为nil

示例：

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

// 此时 u.Name != nil, *u.Name == "Bob"
//      u.Age == nil

常见使用场景与注意事项

使用指针字段的主要目的包括：

• 区分“未设置”和“零值”——例如年龄为0可能是有效值，而nil表示未提供
• 节省内存，避免大对象拷贝
• 配合 omitempty 实现条件性输出

需要注意的问题：

• 直接访问nil指针会引发panic，解码后需判断是否为nil
• 默认值处理要小心，比如想设置默认年龄时不能直接写 if u.Age == nil
• 结构体初始化时，不要假设指针字段有默认值