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,未出现在结果中。
立即学习“go语言免费学习笔记(深入)”;
指针字段的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 - 结构体初始化时,不要假设指针字段有默认值










