在golang的json序列化中,正确使用omitempty tag需注意:1. 评估字段零值是否有业务含义,若有则不应使用omitempty;2. 使用指针类型以区分“缺失”和“零值”;3. 如需更精细控制可自定义marshaler和unmarshaler接口。指针类型在序列化时若为nil会输出null,反序列化时null会被转为nil指针,而值类型始终以零值存在,且无法区分是否缺失。此外,值类型在性能上优于指针类型,但差异通常可忽略,选择应基于业务需求和数据结构特点。

Golang的JSON序列化中,指针和值类型在处理null值和修改原始数据方面存在显著差异。指针可以表示“缺失”或“空”的状态,而值类型总是会有一个默认值。此外,序列化时tag的使用也需要注意,特别是omitempty选项,它会影响字段在JSON输出中的存在与否。

解决方案
当使用
json.Marshal进行序列化时,Golang会根据结构体字段的类型和tag来决定如何处理。
-
指针类型: 如果指针指向的值是
nil
,那么序列化后的JSON中该字段的值会是null
。这对于表示可选字段或数据缺失的情况非常有用。 -
值类型: 值类型在没有显式赋值的情况下,会使用其零值进行序列化。例如,
int
类型的零值是0,string
类型的零值是空字符串""
。 -
omitempty tag:
omitempty
选项告诉JSON编码器,如果字段是零值,则在JSON输出中省略该字段。这可以减少JSON的大小,并使API响应更简洁。
示例代码:
立即学习“go语言免费学习笔记(深入)”;

package main
import (
"encoding/json"
"fmt"
)
type Person struct {
Name *string `json:"name,omitempty"`
Age int `json:"age,omitempty"`
Address string `json:"address"`
}
func main() {
// 指针类型为nil
person1 := Person{
Age: 30,
Address: "Beijing",
}
json1, _ := json.Marshal(person1)
fmt.Println(string(json1)) // 输出: {"age":30,"address":"Beijing"}
// 指针类型有值
name := "Alice"
person2 := Person{
Name: &name,
Age: 30,
Address: "Beijing",
}
json2, _ := json.Marshal(person2)
fmt.Println(string(json2)) // 输出: {"name":"Alice","age":30,"address":"Beijing"}
// 值类型为零值
person3 := Person{
Name: &name,
Address: "Beijing",
}
json3, _ := json.Marshal(person3)
fmt.Println(string(json3)) // 输出: {"name":"Alice","address":"Beijing"}
}如何正确使用omitempty
tag以避免意外的序列化行为?
omitemptytag虽然可以精简JSON输出,但也可能导致一些意外的行为。例如,如果一个字段的值是业务上有意义的零值(比如0代表某种状态),那么使用
omitempty可能会导致该字段被省略,从而丢失信息。
最佳实践:

-
仔细评估: 在使用
omitempty
之前,仔细评估该字段的零值是否具有业务含义。如果零值有意义,则不应使用omitempty
。 -
使用指针: 如果需要区分“缺失”和“零值”,可以使用指针类型。指针类型可以表示
nil
,从而明确地表示该字段缺失。 -
自定义序列化/反序列化: 如果需要更精细的控制,可以实现
Marshaler
和Unmarshaler
接口,自定义序列化和反序列化的逻辑。
指针类型在反序列化时如何处理?
反序列化时,如果JSON中的字段值为
null,那么对应的指针类型字段会被设置为
nil。这与序列化时的行为一致。
示例代码:
立即学习“go语言免费学习笔记(深入)”;
package main
import (
"encoding/json"
"fmt"
)
type Person struct {
Name *string `json:"name"`
Age *int `json:"age"`
Address string `json:"address"`
}
func main() {
jsonStr := `{"name":null,"age":30,"address":"Beijing"}`
var person Person
err := json.Unmarshal([]byte(jsonStr), &person)
if err != nil {
fmt.Println(err)
return
}
fmt.Printf("%+v\n", person) // 输出: {Name: Age:0xc00001e0b8 Address:Beijing}
fmt.Println(person.Name == nil) // 输出: true
} 值类型和指针类型在性能上有差异吗?
一般来说,值类型在性能上会略优于指针类型。因为值类型直接存储数据,而指针类型需要额外的内存空间来存储指针,并且在访问数据时需要进行解引用操作。但是,在大多数情况下,这种性能差异可以忽略不计。
选择的依据:
选择值类型还是指针类型,主要取决于业务需求和数据结构的特点。如果需要表示“缺失”或“空”的状态,或者需要在函数内部修改原始数据,则应使用指针类型。否则,可以使用值类型以获得更好的性能。










