Go语言通过encoding/json包实现JSON序列化与反序列化,核心方法为json.Marshal和json.Unmarshal。结构体字段需首字母大写才能导出,使用json标签可自定义字段名、忽略空值(omitempty)或排除字段(-)。处理动态结构时可用map[string]interface{},解析后数字为float64类型,需类型断言。time.Time默认序列化为RFC3339格式,自定义格式需定义新类型并实现MarshalJSON和UnmarshalJSON方法。JSON数组映射为slice,嵌套对象映射为嵌套结构体或map。正确使用标签、类型和接口可应对大多数JSON场景。

在Go语言开发中,JSON的序列化与反序列化是处理API、配置文件和数据传输的常见需求。Go标准库encoding/json提供了json.Marshal和json.Unmarshal两个核心方法,使用简单但细节丰富。掌握这些细节,能避免常见坑点,提升代码健壮性。
结构体标签控制字段映射
Go结构体字段必须以大写字母开头才能被json包访问。通过json:标签可自定义JSON字段名、控制是否忽略空值等。
例如:
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"`
Password string `json:"-"`
}
说明:
立即学习“go语言免费学习笔记(深入)”;
处理动态或未知结构数据
当JSON结构不确定时,可以使用map[string]interface{}或interface{}接收数据。
示例:
var data map[string]interface{}
err := json.Unmarshal([]byte(jsonStr), &data)
if err != nil {
log.Fatal(err)
}
fmt.Println(data["name"])
注意:解析后的数字默认为float64类型,字符串为string,布尔为bool,需做类型断言。
时间字段的格式化处理
Go中time.Time默认序列化为RFC3339格式,如"2023-08-15T10:00:00Z"。若需自定义格式(如"2006-01-02"),需使用自定义类型。
例如:
type CustomTime struct {
time.Time
}
func (ct *CustomTime) UnmarshalJSON(b []byte) error {
s := strings.Trim(string(b), "\"")
t, err := time.Parse("2006-01-02", s)
if err != nil {
return err
}
ct.Time = t
return nil
}
func (ct CustomTime) MarshalJSON() ([]byte, error) {
return []byte(fmt.Sprintf("\"%s\"", ct.Time.Format("2006-01-02"))), nil
}
将该类型用于结构体字段,即可实现自定义时间格式的序列化与反序列化。
处理JSON数组与嵌套结构
JSON数组可直接映射为Go的slice。嵌套对象映射为嵌套结构体或map。
例如:
type Address struct {
City string `json:"city"`
Zip string `json:"zip"`
}
type User struct {
Name string `json:"name"`
Addresses []Address `json:"addresses"`
}
只要JSON结构匹配,Unmarshal会自动填充嵌套字段。确保字段类型和标签正确即可。
基本上就这些。掌握结构体标签、interface{}处理动态数据、时间格式化和嵌套结构映射,就能应对大多数JSON场景。关键是理解Marshal和Unmarshal的行为规则,避免类型不匹配和空值处理问题。










