在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可能会导致该字段被省略，从而丢失信息。
最佳实践：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
仔细评估: 在使用
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:<nil> Age:0xc00001e0b8 Address:Beijing}
fmt.Println(person.Name == nil) // 输出: true
}值类型和指针类型在性能上有差异吗？
一般来说，值类型在性能上会略优于指针类型。因为值类型直接存储数据，而指针类型需要额外的内存空间来存储指针，并且在访问数据时需要进行解引用操作。但是，在大多数情况下，这种性能差异可以忽略不计。
选择的依据：
选择值类型还是指针类型，主要取决于业务需求和数据结构的特点。如果需要表示“缺失”或“空”的状态，或者需要在函数内部修改原始数据，则应使用指针类型。否则，可以使用值类型以获得更好的性能。
