go的encoding/json库通过json.Marshal和Unmarshal实现结构体与JSON互转,配合Struct标签可自定义字段名、忽略空值或私有字段;2. 使用map[String]Interface{}和类型断言处理动态JSON,注意数字默认解析为float64;3. 对大文件采用json.Decoder/Encoder流式读写以节省内存;4. 关键细节包括omitempty触发条件、string标签用于数值转字符串及RawMessage延迟解析。

在golang中,encoding/json 是处理JSON数据的标准库,广泛用于Web服务、api开发和配置解析。它提供了将Go结构体与JSON格式相互转换的能力,使用简单且性能良好。下面介绍常用方法和技巧,帮助你高效处理JSON数据。
1. 基本的JSON序列化与反序列化
Go中最常用的两个函数是 json.Marshal 和 json.Unmarshal。
json.Marshal 将Go值转换为JSON字符串:
type User struct { Name string `json:"name"` Age int `json:"age"` Email string `json:"email,omitempty"` } user := User{Name: "Alice", Age: 25} data, _ := json.Marshal(user) // 输出:{"name":"Alice","age":25}
json.Unmarshal 将JSON数据解析到Go变量:
立即学习“go语言免费学习笔记(深入)”;
jsonData := `{"name":"Bob","age":30,"email":"bob@example.com"}` var user User json.Unmarshal([]byte(jsonData), &user) // user.Name == "Bob", user.Age == 30, user.Email == "bob@example.com"
2. 结构体标签(Struct Tags)控制字段映射
通过 json: 标签可以自定义字段名、忽略空值或跳过字段。
- json:”fieldName”:指定JSON中的键名
- json:”-“:忽略该字段不参与序列化/反序列化
- json:”,omitempty”:当字段为空值时(如零值、nil、空字符串等),不输出到JSON
- json:”,string”:将数值或布尔值以字符串形式编码(适用于int64转string等场景)
type Product struct { ID int64 `json:"id,string"` // 输出为字符串数字 Name string `json:"product_name"` Price float64 `json:"price,omitempty"` Secret string `json:"-"` // 不导出 }
3. 处理未知或动态JSON结构
当无法提前定义结构体时,可使用 map[string]interface{} 或 interface{} 接收数据。
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30
var data map[string]interface{} json.Unmarshal([]byte(`{"name":"Tom","age":28,"active":true}`), &data) // 访问字段需类型断言 name := data["name"].(string) age := int(data["age"].(float64)) // 注意:JSON数字默认解析为float64
也可以使用 json.RawMessage 延迟解析部分JSON内容,提升性能或实现条件解析。
4. 流式读写大JSON文件
对于大型JSON数据流,推荐使用 json.Decoder 和 json.Encoder,避免一次性加载全部内容。
从文件或http请求中读取JSON流:
file, _ := os.Open("users.json") defer file.Close() decoder := json.NewDecoder(file) for decoder.More() { var user User if err := decoder.Decode(&user); err == nil { // 处理每个user对象 } }
写入流式JSON:
encoder := json.NewEncoder(os.Stdout) encoder.Encode(User{Name: "John", Age: 35})
基本上就这些。熟练掌握 encoding/json 的核心功能后,无论是构建rest api还是解析配置文件,都能得心应手。关键是理解结构体标签的用法、空值处理机制以及如何应对动态结构。不复杂但容易忽略细节,比如 float64 的类型转换和 omitempty 的触发条件。
