指针和值类型在Golang JSON序列化时的区别演示tag使用的注意事项-Golang-PHP中文网

指针和值类型在Golang JSON序列化时的区别演示tag使用的注意事项

P粉602998670

发布： 2025-08-03 09:09:02

原创

214人浏览过

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

指针和值类型在Golang JSON序列化时的区别演示tag使用的注意事项

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以避免意外的序列化行为？

omitempty

登录后复制

tag虽然可以精简JSON输出，但也可能导致一些意外的行为。例如，如果一个字段的值是业务上有意义的零值（比如0代表某种状态），那么使用

omitempty

登录后复制

可能会导致该字段被省略，从而丢失信息。

最佳实践：

ExcelFormulaBot

在AI帮助下将文本指令转换为Excel函数公式

129

查看详情

仔细评估: 在使用
```
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
}

登录后复制