Go语言中encoding/json包通过json.Marshal和json.Unmarshal实现JSON处理，结合结构体标签控制字段映射，支持动态解析与自定义序列化。1. 结构体字段需大写可导出，使用json:"name"指定键名，omitempty忽略空值，-排除字段。2. 动态JSON可用map[string]interface{}解析，但数字默认转为float64，嵌套结构变为map或slice，适用于配置读取但影响类型安全。3. 自定义类型可实现json.Marshaler和json.Unmarshaler接口，如CustomTime统一日期格式“2006-01-02”。4. 常见注意点：nil指针序列化为null；反序列化必须传指针；标签拼写错误导致静默失败；建议标注所有json标签，使用omitempty减少冗余，并对关键字段校验有效性。5. 复杂场景可用json.RawMessage延迟解析。掌握这些技巧可高效处理Web API、配置文件等JSON需求。
Go语言的encoding/json包为JSON数据的解析与序列化提供了强大且高效的支持。在实际开发中，无论是构建Web API、处理配置文件，还是进行微服务间通信，都离不开对JSON的操作。本文将围绕常用场景，介绍如何正确使用json.Marshal和json.Unmarshal，并分享一些实用技巧。
结构体标签控制字段映射
Go结构体字段通过json:标签控制序列化和反序列化时的键名。这是实现JSON与结构体灵活映射的关键。
例如：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"` // 空值时忽略
Password string `json:"-"` // 不参与序列化
}
说明：
立即学习“go语言免费学习笔记（深入）”；
-
omitempty表示当字段为空（零值）时不输出到JSON -
-用于完全忽略字段 - 字段必须是大写字母开头（可导出），否则
json包无法访问
处理动态或未知结构的JSON
当无法提前定义结构体时，可以使用map[string]interface{}或interface{}来解析任意JSON对象。
示例：
data := `{"name": "Alice", "age": 30, "active": true}`
var v map[string]interface{}
if err := json.Unmarshal([]byte(data), &v); err != nil {
log.Fatal(err)
}
fmt.Println(v["name"], v["age"])
注意：
- 数字类型默认解析为
float64，即使原始是整数 - 嵌套对象会变成嵌套的
map或slice - 适用于临时解析或配置读取，但应避免在核心逻辑中频繁使用，影响类型安全
自定义序列化行为
某些类型（如时间、枚举、特殊数值）需要定制JSON输出格式。可通过实现json.Marshaler和json.Unmarshaler接口完成。
以时间格式为例：
type CustomTime struct {
time.Time
}
func (ct *CustomTime) MarshalJSON() ([]byte, error) {
return []byte(fmt.Sprintf(`"%s"`, ct.Time.Format("2006-01-02"))), nil
}
func (ct *CustomTime) UnmarshalJSON(data []byte) error {
layout := "2006-01-02"
parsed, err := time.Parse(layout, strings.Trim(string(data), `"`))
if err != nil {
return err
}
ct.Time = parsed
return nil
}
这样可以在结构体中使用CustomTime来统一日期格式，避免前端兼容问题。
常见陷阱与最佳实践
使用encoding/json时有几个容易忽视的问题：
- 指针字段序列化时，nil指针不会报错，但输出为null
- 反序列化时，目标变量需传指针，否则无法修改原值
- 字段标签拼写错误会导致静默失败（字段不生效）
- 结构体字段不可导出则无法被
json包访问
建议：
- 定义结构体时明确标注
json标签，即使名称一致 - 使用
json:",omitempty"减少冗余输出 - 对关键字段做反序列化后校验（如非空、格式等）
- 复杂场景可结合
json.RawMessage延迟解析部分字段
基本上就这些。掌握encoding/json的核心用法后，能应对大多数JSON处理需求。关键是理解结构体标签、接口定制和类型转换的机制，写出清晰且健壮的代码。
