Go中零值与空值的实现与区别

更新时间：2026年02月26日 09:21:14 作者：凉凉的知识库

本文主要介绍了Go中零值与空值的实现与区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

内置类型的零值/默认值

变量声明但未显式初始化时，Go 自动赋的默认值。它保证“未初始化”也有确定、可用的值

TYPE	ZERO VALUE
Integer	0
Floating point	0.0
Boolean	false
String	""
Pointer	nil
Interface	nil
Slice	nil
Map	nil
Array	fields zero (每个元素都是其零值)
Struct	fields zero (每个元素都是其零值)
Channel	nil
Function	nil

Json序列化中的omitempty&omitzero

omitempty

当对一个结构体的某个字段的tag设置为omitempty时，如果这个字段是空值（empty value，和零值不一样）时，那么这个字段就会在序列化时省略

The “omitempty” option specifies that the field should be omitted from the encoding if the field has an empty value, defined as false, 0, a nil pointer, a nil interface value, and any empty array, slice, map, or string.

omitempty标签的判断逻辑如下：

对于布尔类型：false被视为空
对于数值类型：0被视为空
对于指针、接口：nil被视为空
对于字符串：""（空字符串）被视为空
对于数组、切片、map：长度为0被视为空，既包含未初始化的又包含空的

对于空结构体、所有字段都为默认值的零值结构体、以及一些实际含义为零的结构体（例如time.Time{})，omitempty都无能为力，会进行输出。

因此在Go 1.24之前想对某个结构体不输出，可选的一种方案是使用指针类型

type VanillaStruct struct {
    StructTyp1 struct{}        // 空结构体
    StructTyp2 struct{ A int } // 零值结构体
    TimeTyp    time.Time       // 实际含义为零的结构体

    StructTyp3 *struct{}
    StructTyp4 *struct{ A int }
    TimeTyp2   *time.Time
}

type OmitemptyStruct struct {
    StructTyp1 struct{}        `json:",omitempty"`
    StructTyp2 struct{ A int } `json:",omitempty"`
    TimeTyp1   time.Time       `json:",omitempty"`

    StructTyp3 *struct{}        `json:",omitempty"`
    StructTyp4 *struct{ A int } `json:",omitempty"`
    TimeTyp2   *time.Time       `json:",omitempty"`
}

func main() {
    s1 := VanillaStruct{}
    ss1, err := json.Marshal(s1)
    fmt.Println(err, string(ss1)) 
    // {"StructTyp1":{},"StructTyp2":{"A":0},"TimeTyp":"0001-01-01T00:00:00Z","StructTyp3":null,"StructTyp4":null,"TimeTyp2":null}

    s2 := OmitemptyStruct{}
    ss2, err := json.Marshal(s2)
    fmt.Println(err, string(ss2)) 
    // {"StructTyp1":{},"StructTyp2":{"A":0},"TimeTyp1":"0001-01-01T00:00:00Z"}
}

omitzero

Go 1.24 给 encoding/json 新增omitzero：按零值(zero value)省略

在序列化时，omitzero选项指定如果字段值为零，则该结构体字段应被省略

如果该类型定义了IsZero() bool方法，那么这个零值就通过IsZero方法来判断
否则是根据字段是否是零值（通过reflect.Value.IsZero判断）来判断

type VanillaStruct struct {
    StructTyp1 struct{}        // 空结构体
    StructTyp2 struct{ A int } // 零值结构体
    TimeTyp    time.Time       // 实际含义为零的结构体
}

type OmitzeroStruct struct {
    StructTyp1 struct{}        `json:",omitzero"`
    StructTyp2 struct{ A int } `json:",omitzero"`
    TimeTyp1   time.Time       `json:",omitzero"`
}

func main() {
    s1 := VanillaStruct{}
    ss1, err := json.Marshal(s1)
    fmt.Println(err, string(ss1))
    // {"StructTyp1":{},"StructTyp2":{"A":0},"TimeTyp":"0001-01-01T00:00:00Z"}

    s2 := OmitzeroStruct{}
    ss2, err := json.Marshal(s2)
    fmt.Println(err, string(ss2))
    // {}
}

总结

下面是一个完整的Go示例，展示了omitempty&omitzero标签在不同类型上的应用：

TYPE	ZERO VALUE	EMPTY VALUE	WITHOUT OMIT	OMITEZERO	OMITEMPTY
Integer	0	0	0	OMIT	OMIT
Floating point	0	0	0	OMIT	OMIT
Boolean	FALSE	FALSE	FALSE	OMIT	OMIT
String	""	""	""	OMIT	OMIT
Pointer	nil	nil	null	OMIT	OMIT
Interface	nil	nil	null	OMIT	OMIT
Slice	nil	nil	null	OMIT	OMIT
Slice	nil	make([]T, 0)	[]	[]	OMIT
Map	nil	nil	null	OMIT	OMIT
Map	nil	make(map[K]V, 0)	{}	{}	OMIT
Array: [0]T	fields zero	[0]T	[]	OMIT	OMIT
Array: [N]T	fields zero	❌	[T]	OMIT	[T]
Struct: struct{}	fields zero	❌	{}	OMIT	{}
Struct: struct{ F T }	fields zero	❌	{"F": T}	OMIT	{"F": T}
Channel	nil	nil	❌	❌	❌
Function	nil	nil	❌	❌	❌

到此这篇关于Go中零值与空值的实现与区别的文章就介绍到这了,更多相关Go 零值空值内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Go log库的使用示例详解
Go语言内置的log库提供了基本的日志记录功能,支持日志的格式化输出、设置日志前缀、配置输出位置等,可以通过标准logger或创建新的Logger对象来使用,log库简单易用,但功能有限,可能需要配合第三方日志库如logrus、zap等来满足复杂需求
2024-09-09
Go Generate 代替 Makefile使用方法详解
这篇文章主要为大家介绍了Go Generate 代替 Makefile使用方法详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-12-12
详解go-zero如何使用validator进行参数校验
这篇文章主要介绍了如何使用validator库做参数校验的一些十分实用的使用技巧,包括翻译校验错误提示信息、自定义提示信息的字段名称、自定义校验方法等,感兴趣的可以了解下
2024-01-01
golang查看CPU使用率与内存的方法详解
这篇文章主要给大家介绍了golang查看CPU使用率与内存的方法,以及拓展介绍源码里//go:指令,文中有详细的代码示例以及图文介绍,需要的朋友可以参考下
2023-10-10
详解Go 依赖管理 go mod tidy
这篇文章主要为大家介绍了详解Go 依赖管理 go mod tidy，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-10-10
Go语言使用kafka-go实现Kafka消费消息
本篇文章主要介绍了使用kafka-go库消费Kafka消息,包含FetchMessage和ReadMessage的区别和适用场景,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的可以了解一下
2024-12-12
Go routine调度详解
这篇文章主要介绍了Go routine调度详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-01-01
Go第三方框架ants协程池框架的实现
本文主要介绍了Go第三方框架ants协程池框架的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2026-04-04
golang-gin-mgo高并发服务器搭建教程
这篇文章主要介绍了golang-gin-mgo高并发服务器搭建教程，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-12-12
Golang基于Vault实现敏感数据加解密
数据加密是主要的数据安全防护技术之一，敏感数据应该加密存储在数据库中，降低泄露风险，本文将介绍一下利用Vault实现敏感数据加解密的方法，需要的可以参考一下
2023-07-07